Re: [boost] [Log] Review Results

Subject: Re: [boost] [Log] Review Results
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2010-03-11 14:54:52

On 03/11/2010 10:41 PM, John Bytheway wrote:
> Andrey Semashev wrote:
>> On 03/10/2010 08:52 PM, Roland Bock wrote:
>>> - none of the code examples is complete. They are missing the
>>> namespace declarations documented in the introduction, at least.
>>> While brevity is good, it would be very helpful to have complete,
>>> compiling examples in the tutorial
>>
>> I don't think adding namespaces and includes to examples in the readable
>> documentation is a good idea. As you noted, these examples should be
>> brief and free of such noise. However, I will reorganize the docs, so
>> that the code samples will be taken from compilable external files.
>
> Other boost docs have extracts but also links to the full source code.
> I think that works well.

Agreed, that seems to be the best solution.