Re: [boost] Documentation Redux (was Re: Boost 1.36.0 release notice)

From: Daniel Wallin (daniel_at_[hidden])
Date: 2008-08-18 08:23:56

John C. Femiani wrote:
> Daniel Wallin wrote:
>> If we were to explore that path, http://sphinx.pocoo.org might be of
>> interest. It's a documentation framework built on docutils, that could
>> give us a uniform look and feel, plus cross referencing. Seems geared
>> toward Python, but I'm sure it could be extended with whatever docnodes
>> we could need.
>>
>>   
> As a user, I would prefer the OP's suggestion of using the Trac wiki. 

As a developer, editing documentation in a wiki is horrible. In fact,
IIRC, even the trac project itself is moving away from having the docs
in the wiki.

> Then only the server would need the LaTeX plug in configured.

That's true for whatever solution we use.

-- 
Daniel Wallin
BoostPro Computing
http://www.boostpro.com