Re: [boost] [Log] Review Results

Subject: Re: [boost] [Log] Review Results
From: John Bytheway (jbytheway+boost_at_[hidden])
Date: 2010-03-11 14:41:00

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.

John Bytheway