Re: Re: Pear documentation
| From: | Martin Jansen | Date: | Wed, 10 Oct 2001 06:19:05 +0000 |
| Subject: | Re: Re: Pear documentation | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-2215@lists.php.net to get a copy of this message | ||
On Wed, 10 Oct 2001 01:19:50 +0200, Markus Fischer wrote:
>Just adopt the existing standards. Ie, check out the current
>php.net doc und pearify it. Or use php-gtk-doc. Or even ZendAPI
>doc. All are using docbook.
But Docbook still seems to be a problem for lots of people here.
Quoting Bjoern Schotte:
| ( .oO("Oh dear,
| I have to learn DocBook, that's shit, I think I won't write any
| tutorial, people should RTFM or die.") ).
I also see this problem, that lots of people don't want to look into
Docbook. We could perhaps avoid this by setting up a very simple
skeleton for the developers, so they can easily Copy&Paste their
documentation without having to learn Docbook.
>(James
>Moore comes into my mind but I'm sure there are others too)
I approached James yesterday and the day before yesterday since I
wanted to build the GTK Manual on my machine to see how the GTK
guys solved the documentation problem. He answered some of my question
but didn't answer on my last problem, which still prevents me from
successfully building the manual :-).
- Martin