Subject: Re: [boost] [doc] Liven up Boost Documentation with Java Script?
From: Kris (krzysztof_at_[hidden])
Date: 2016-02-26 11:20:28
Paul Fultz II wrote
> On Thursday, February 25, 2016 at 4:10:38 PM UTC-6, Robert Ramey wrote:
>> 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
>> >> 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
>> >> result in convincing boost library authors to experiment with
>> >> commenting with their documentation?
>> > I am not proposing using some new markup nor I am not proposing that
>> > boost
>> > libraries jump ship to mkdocs either.
>> Then exactly what ARE you proposing?
>> I am proposing to use mkdocs to generate the documentation, but by no
>> I proposing that ever boost library switch over to mkdocs. If other
>> prefer quickbooks than thats great.
>> > 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?
>> For me, consume the documentation. However, Krzysztofmay who has started
>> thread is proposing something much larger.
> Actually, I started this thread to discuss what boost community think
> about interactive documentation
> in general. Just wanted to get feedback whether there is interest in such
> approach or not and if yes
> what exactly would be most useful.
> I wasn't planning to talk about implementation details at all. Honestly, I
> don't really mind whether doc
> will be written in quickbook, markdown or doxygen. I have tried all of
> them and found markdown
> to be the easiest to achieve what I wanted, but it's just my opinion. I'm
> not trying to convince
> anyone here.
>> Robert Ramey
>> Unsubscribe & other changes:
> Unsubscribe & other changes:
-- View this message in context: http://boost.2283326.n4.nabble.com/doc-Liven-up-Boost-Documentation-with-Java-Script-tp4683773p4683871.html Sent from the Boost - Dev mailing list archive at Nabble.com.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk