Re: future of PEAR
| From: | Stefan Neufeind | Date: | Tue, 11 Nov 2003 23:20:41 +0000 |
| Subject: | Re: future of PEAR | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-23483@lists.php.net to get a copy of this message | ||
On 11 Nov 2003 at 20:53, Martin Jansen wrote:
> On Tue Nov 11, 2003 at 08:2057PM +0100, Tobias Schlitt wrote:
> > Correct. It's a real torture to do docbook stuff, if you do not
> > handle that in everyday work.
>
> I do not want to promise too much, so please don't take it at face
> value yet. Anyway: The PEAR Group is currently evaluating reST [1] as
> an alternative to Docbook. This will help developers to more easily
> write documentation.
>
> The remaining thing that needs to be figured out, is a smart way to
> integrate the reST markup into peardoc's XML structure.
>
> [1] http://docutils.sf.net/rst.html
Just a while ago I read an article in the German Linux Magazine about
editing docbook using OpenOffice. Wouldn't that be a point that could
be followed further? Like, writing a doc for everybody how to use
common and freely available tools like OpenOffice to write docs? So
wouldn't following the way of docbook be a good idea since it's a
settled standard for writing docs - although hard to do without
appropriate tools, agreed.
Stefan