Re: [boost] Improving Boost Docs

Subject: Re: [boost] Improving Boost Docs
From: Robert Ramey (ramey_at_[hidden])
Date: 2017-08-15 04:08:50

On 8/14/17 5:34 PM, Glen Fernandes via Boost wrote:
> On Mon, Aug 14, 2017 at 8:31 PM, Robert Ramey via Boost wrote:
>> On 8/14/17 10:37 AM, John Maddock via Boost wrote:
>>>
>>> BTW is there any reason to continue using the Boostbook customisation
>>> layer?  Is anyone actually using it?  I'm fairly sure quickbook doesn't, and
>>> it would sure simplify the build process to leave out one level of XSL
>>> transformation.  Sadly we would need an XSL expert to sort that mess out I
>>> suspect :(
>>
>>
>> I think there's a little more to this:
>>
>> a) There are special tags like class, struct, etc. etc.  Which permit
>> tagging for different aspects of C++ syntax.  Somehow I doubt anyone is
>> using this stuff.  It would be pain to edit it and it would presume that
>> every class,struct etc would have the same documentation structure which
>> might be inconvenient.  Also the documentation for this is reference and
>> doesn't give much in the way of sample output etc.  Upshot I'm doubtful that
>> anyone is using it.
>>
> 
> Is the Boost.Array documentation not using this?
> https://github.com/boostorg/array/tree/develop/doc

Yep - there it is!
> 
> Glen
> 
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
>