7 Oct
2017
7 Oct
'17
5:30 p.m.
On Sat, Oct 7, 2017 at 10:25 AM, John Maddock via Boost <boost@lists.boost.org> wrote:
...standardese does not make good documentation
That's correct. However, it DOES make a good reference. For example, here's a reference (generated with a tool): <http://www.boost.org/doc/libs/develop/libs/beast/doc/html/beast/quickref.html> <http://www.boost.org/doc/libs/develop/libs/beast/doc/html/beast/ref/boost__beast__http__async_write/overload1.html> And here's "documentation" (i.e. the exposition written by hand) <http://www.boost.org/doc/libs/develop/libs/beast/doc/html/beast/using_http/message_stream_operations.html> Lets use the tools for where they do the most good rather than making blanket statements about not using them. Thanks