Re: File_CSV as standalone package?

From: Date: Sun, 31 Aug 2003 05:50:49 +0000
Subject: Re: File_CSV as standalone package?
References: 1 2 3 4 5  Groups: php.pear.dev php.pear.doc 
Request: Send a blank email to pear-dev+get-20915@lists.php.net to get a copy of this message
Hi Marshall, I just committed new documentation yesterday on how to write documentation (it's not in-depth with the use of peardoc, but does link to the skeleton Alex Merz designed). It will appear when the manual is re-built. There is much to be added to this section of the manual, I am happy to continue to augment it as time goes on, but others should also add to it, and correct it as well (I won't get upset if someone changes my writing in CVS - I will just edit it if I'm not completely happy with the changes). There is a description in the manual on how to write docs in DocBook, and what to do with them, but it's hard to find. In fact, that's a bigger problem than your needed tutorial - I can never find what I'm looking for in the manual :). I don't yet have a good answer to this problem, so I will leave it at that. Greg Marshall Roch wrote:
Tomas V.V.Cox wrote:
Since many time I like to make it a separate package. But cause I'm lazy I never find time for writing doc I haven't done it yet.
Maybe it would be a better use of time to write documentation on how to write documentation. I don't know how to write docs further than the inline comments, but I'd probaby write some basic stuff for my classes to be put in the PEAR manual if there was a tutorial describing how the writing and submission processes go. Or maybe someone could outline the process here and someone else could put it into peardoc or whatever the proper format is, so it can be put in the manual.


« previous php.pear.dev (#20915) next »