Re: Re: PEAR Descriptions/More documentation

Quoting Markus Wolff <wolff@21st.de>: > I never said that there is no need for API documentation or that > tutorials should be the only form of documentation. > > What I said is that I think a tutorial is better for getting started - > and most people that I know think the same way. > > Of course, once you know how a certain class is working in general, good > and up-to-date API docs are essential. No, no, no, again, no: once _you_ know. That's how _you_ learn. All I'm asking you to do is to acknowledge that you are not how people universally work and that different people learn in different ways, and you keep saying "Yes, but I like it this way." > You said it yourself - it´s probably best to have both. Unfortunately, > for most PEAR classes, this is presently not the case. This is why I > don´t understand that if someone stands up and offers to volunteer for > more and better documentation, all the feedback he gets is something > like "why more and better? There already is enough.". Yeah, for some > people it may seem like that. But certainly not for everyone. I missed that part of the conversation, I apologize. More documentation is certainly a good thing. -chuck -- Charles Hagenbuch, <chuck@horde.org> Some fallen angels have their good reasons.