Re: [xml] Bug or User Error

[Daniel Veillard <veillard redhat com>]

On Fri, Jan 30, 2004 at 09:45:45AM +0100, Peter Jacobi wrote:
> Hi Daniel, All,

  Hi Peter,

> New year, new off-topic posting quota!
>
> Thanks a lot for the great work, again, BTW!
>
> Daniel wrote:
> >   Why bother building docs ? People simply don't bother to read them :-( it
> > is *extremely* frustrating :-(
> >   Why did you call xmlCleanupParser() for each document ????
>
> On our commercial product, we started with a 200 page manual, covering 
> everything. Of course nobody read it.
>
> We dumbed it down to 20 pages. Due to insufficent control of the external 
> translators, some silly stuff was in it. Nobody complained. We deduced, 
> nobody read it.
>
> Now we have a one page "getting started" instruction sheet. 
>
> (Of course online help also available but never used)
>
> Optimistic people would assume, that software developers would have another 
> attitude towards reading docs. 
>
> Daniel, most of those who read the online docs, don't show up with 
> redundant questions in the list, so it's only selective perception, which 
> lets you assume nobody reads yours docs. I hope.

  Well, thanks for the story :-)
How should I proceed ?
Why so little people contributed code examples as I suggested ?
Should I just ignore posts which irritates me ?

  feedback welcome, you've seen the list and myself in action over the
last years ...

Daniel

-- 
Daniel Veillard      | Red Hat Network https://rhn.redhat.com/
veillard redhat com  | libxml GNOME XML XSLT toolkit  http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/