Re: [boost] From an user to developers

Subject: Re: [boost] From an user to developers
From: Stéphane Vandenbogaerde (svdbg_at_[hidden])
Date: 2012-06-10 08:15:27

Le 08/06/2012 19:06, Stewart, Robert a écrit :

>> 1. the history of all releases, with notes for each release
>
> There are per-library release notes managed at the release level visible on boost.org.

Yes, but when you're unterested in a specific library, it is tedious to 
check each Boost release, even if the concerned library hasn't been 
updated in this Boost release.

>> 2. the motivation of their library
>
> I agree that this is useful.  It can be difficult to grasp the value of a library when first reading about it.

Great. I have been understood. :-)

> There are a great many new C++11 features.  It would be inordinately burdensome
 > to expect each library maintainer to indicate which of those features 
have been
 > used, won't be used, etc.

They cold at least say something like that :

"Since the C++11 release, some features may be obsolete. I'll update the 
documentation when I'll have time. Feel free to help me to check each 
feature against C++11".

Maybe a wiki would be useful.

> Increasingly, there is commonality among the various libraries.
> Older libraries predate the current documentation mechanisms,
 > so would be nontrivial to update.  Some libraries are
> documented with standardization in mind, and while I understand
> the motivation for the resulting standard-like documentation
> format, it isn't accessible to normal users.
>
> Most of these issues can be addressed, however, by filing bugs
 > and supplying patches.  Most of the maintainers would apply,
 > if not welcome, useful documentation improvements.

I think an unofficial wiki wuuld be useful in this purpose. The official 
maintainer could then pick the info when he has time to update the doc.