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 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?
I am proposing to use mkdocs to generate the documentation, but by no means am I proposing that ever boost library switch over to mkdocs. If other developers 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 this 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: http://lists.boost.org/mailman/listinfo.cgi/boost
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- View this message in context: http://boost.2283326.n4.nabble.com/doc-Liven-up-Boost-Documentation-with-Jav... Sent from the Boost - Dev mailing list archive at Nabble.com.