Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide)
| From: | Jon Parise | Date: | Wed, 11 Jun 2003 18:36:31 +0000 |
| Subject: | Re: reStructuredText (was: RE: [PEAR-DEV] Net_SMTP user's guide) | ||
| References: | 1 2 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-17320@lists.php.net to get a copy of this message | ||
On Wed, Jun 11, 2003 at 07:06:42PM +0200, Lukas Smith wrote:
> > I mention this here because I authored the documentation using
> > reStructuredText and docutils (http://docutils.sf.net/). I found it
> > to be a very comfortable system for writing package documenation and
> > wanted to mention it to the development community at large.
>
> This looks to be like what wiki is to CMS for documentation :-)
Yes, that's a good analogy. A lot of wikis use a form of structured
text in their markup engines.
I like it for documentation because, unlike DocBook, the "source"
document is as readable as the rendered versions.
--
Jon Parise (jon@php.net) :: The PHP Project (http://www.php.net/)