|
Boost : |
Subject: Re: [boost] [doc] Liven up Boost Documentation with Java Script?
From: Robert Ramey (ramey_at_[hidden])
Date: 2016-02-25 17:10:25
On 2/24/16 11:59 AM, Paul Fultz II wrote:
>> My point is that there are two ways to go:
>>
>> a) convince boost library developers to create a whole new markup for
>> their documentation so they can test/use your proposed infrastructure to
>> add commenting to their documentation.
>>
>> b) make a small optional add-on to boost book using xslt which would
>> work with the markup they already have.
>>
>> Now step back and consider which of the two strategies is more likely to
>> result in convincing boost library authors to experiment with including
>> commenting with their documentation?
>>
>
> I am not proposing using some new markup nor I am not proposing that all
> boost
> libraries jump ship to mkdocs either.
Then exactly what ARE you proposing?
> There should be plenty of room for
> more documentation tools for boost libraries.
More tools in order to ... what exactly.
The demos are pretty cool - but what are you trying to
convince the rest of us to do?
Robert Ramey
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk