Re: [jamboost] Re: Docs structure

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-12-15 02:55:59

On Tuesday 14 December 2004 20:05, David Abrahams wrote:

> > I've not much experience with the former. Regarding the latter -- I don't
> > think I've used tutorial. Requirements for derived type (for
> > iterator_facade) were enough.
>
> Well, I can tell you that demand for the sort of walkthrough we now
> provide was exceedingly high.

Ok, noted.

> > I can compare this to Boost libraries which have Boostbook + doxygen
> > docs. Boostbook parts cover higher level things. doxygen parts have docs
> > for each method of every class. If you try to merge it together, the
> > result will be unusable. We need to somehow separate commonly needed
> > information from rarely needed.
>
> It's my opinion that if you do that there will be many things for which
> the information in the reference and the user manual are exact
> duplicates of one another. But why don't I finish going through
> everything, and then we'll see?

Indeed, why not? I'll be waiting.

- Volodya