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.