Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: Mateusz Loskot (mateusz_at_[hidden])
Date: 2011-09-28 09:00:29

On 27/09/11 16:02, Dave Abrahams wrote:
> on Mon Sep 26 2011, Mateusz Loskot<mateusz-AT-loskot.net>  wrote:
>
>> I'm wondering if there is anything available, discussed or planned
>> regarding integration of the Sphinx [1] documentation generator.
>> Sphinx evolved as mainly used by the Python world, but AFAIS it has been
>> quickly spreading to other camps, C and C++ included.
>> In fact, Sphinx has not only become popular as documentation generator
>> but also as tool to maintain project websites where majority of the
>> content is fairly static and no need for real CMS.
>> Plain text files with source of content and cronjob do the job well.
>>
>> I have found two references in boost-docs archives, [2] and [3],
>> but without in-depth discussion about pros and cons of
>> integrating  Sphinx into the Boost documentation toolset/workflow.
>>
>> Has anyone considered it?
>> Would it be valid to discuss Sphinx for Boost?
>
>
> Sure, it's valid.  We already use ReST for several documents.  However,
> I don't think we should get deeply into a discussion about expanding the
> standard tools without addressing the problem of simplifying the overall
> process

I'd welcome simplificatin but I can't really see how it could be done.
It feels like a tower of babel a bit.

I understand now that having one tool that would keep everyone happy is 
a utopian idea.

Best regards,
-- 
Mateusz Loskot, http://mateusz.loskot.net
Charter Member of OSGeo, http://osgeo.org
Member of ACCU, http://accu.org