Open vinipsmaker opened 8 years ago
Avoid nesting too many [section] blocks.
Done, but boostbook still generates verbose TOC that I'd like to avoid.
Avoid nesting too many [section] blocks.
I've just converted documentation from Boost's QuickBook to asciidoc: https://github.com/BoostGSoC14/boost.http/commit/c535bf73cab03b60b285df7e7bff62c49be99744
I shouldn't have troubles with QuickBook anymore.
std::error_code
).queue_socket
isn't standard and causes confusion. It deserves more attention in documentation (...a page just documenting composed operations...).queue_socket
should be provided (I don't think queue sockets should be a concept, I think they need to be the core of your library's user facing API....).[ ] You've not convinced me why I should use your library and not write some ad hoc code which would be "good enough".
You've not convinced me why I should use your library and not an alternative, including one written in Python or PHP.
At the front of your docs, you need to have me convinced by the end of page 2 that there is no better library than yours, including on other languages. Evidence such as an excellent literature review covering alternatives and benchmarks between your code and alternatives are steps in the right direction.
[section]
blocks.Hints
<title>
tag content something funny.WON'T FIX