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
> 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.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk