Subject: Re: [boost] Asynchronous library now in Boost Library Incubator
From: Christophe Henry (christophe.j.henry_at_[hidden])
Date: 2016-11-30 15:33:37


>I'm trying to digest the docs for this monster work.
>
>One things that strikes me immediately is that the doc preparation
>does not use code snippets, and so code is in boring old
>black'n'white rather than colored syntax.
>For me, that makes it significantly harder to read (and understand) the
code examples.

Ok, I'll see if I can improve this.

>It also means that one doesn't have the assurance that 'What You See is
What Compiles'.

For most features, the doc provides a link to an example, which I regularly
compile.

>(I've also having trouble finding things in all the plentiful 'good
stuff'.
>But that's a common (and largely still unsolved)
>problem with all documentation.)

>Paul

Please let me know what is the "good stuff" for you and I'll make it more
visible.

Cheers,
Christophe