Re: [boost] Reference documentation: one approach

From: William E. Kempf (wekempf_at_[hidden])
Date: 2002-10-29 10:43:38

David Abrahams said:

> I very much dislike the idea of having the /source/ of our docs be in
> any kind of <tag>...</tag> representation. I would like to explore a
> more-readable (and typable) alternative: ReStructuredText.
>
>    http://docutils.sourceforge.net/docs/rst/quickref.html

Interesting.  I dislike a few of the particulars, but all in all a simple
way to create documents.  I'm not sure how it will stack up against
DocBook when it comes to developing large documenation projects such as we
have with Boost, though.  It seems to be more geared towards short and
simple documents.

-- 
William E. Kempf