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<> 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,
Charter Member of OSGeo,
Member of ACCU,

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC