Re: [boost] Core libraries should separated from experimental libraries

Subject: Re: [boost] Core libraries should separated from experimental libraries
From: Thomas Klimpel (Thomas.Klimpel_at_[hidden])
Date: 2009-11-24 07:39:25

Christian Schladetsch wrote:
> Paul A. Bristow wrote:
> > This would mean that when libraries are reviewed for full acceptance,
> > they should have received much more use, feedback and refinement,
> > and be really ready for use by those who want a 'release quality'
> > stable product - including decent documentation.
>
> +1 for making it harder to add a new library to boost.
>
> There are already too many libraries.

These two questions are actually related. A decent documentation should clearly state the problem (or types of problems) the library is solving, so that the user can quickly find out whether he should look at the library in more detail. This significantly reduces the problem of having "too many" libraries. The library name is probably not very important, but the "Categories" tags are, and can also help to reduce the problem of "too many" libraries.

But just to make the main point very clear again. A good documentation is really important, and a good documentation should not only help the actual user of the library, but also the user that still has to find out whether he should really become a user of the library.

Regards,
Thomas