Re: Re: PEAR Descriptions/More documentation
| From: | Martin Jansen | Date: | Wed, 10 Oct 2001 06:19:59 +0000 |
| Subject: | Re: Re: PEAR Descriptions/More documentation | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-2216@lists.php.net to get a copy of this message | ||
On Wed, 10 Oct 2001 00:03:56 +0200, Björn Schotte wrote:
>One remark to the "Should we use DocBook or not?" discussion: I
>think it is counterproductive to discuss the format of such
>documentations *for days*. To bring people forward to write
>Tutorials for their PEAR packages you mustn't have a high entry
>level in writing such Tutorials. Saying "You must write in DocBook"
>*is* a high level because one has to learn DocBook ( .oO("Oh dear,
>I have to learn DocBook, that's shit, I think I won't write any
>tutorial, people should RTFM or die.") ). So you have to lower
>the entry level.
What format would you prefer?
- Martin