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.