Group libraries by topic in the documentation

There are 92 entries in the library overview now (http://www.boost.org/doc/libs). I believe this is quite intimidating for a new user. I have come up with a scheme of grouping things (I don't claim it is perfect and I put libraries that I wasn't sure about into "Others"). Each library should only appear once even if that one category doesn't describe the library's purpose perfectly. The "Others" section could be subdivided further, i.e. Concurrency and Time categories come to mind but I didn't deem that necessary. Additionally, it would be nice to 1) indicate header-only status via a preceding (+) symbol and a library-only status via (-). This can be combined into (+/-) for libraries that support both. 2) indicate deprecated library status via "deprecated, use XXX instead". 3) indicate expected learning curve via color (green, yellow, red) where red is intended for something like Proto and green for Any. Yellow could be used for a library like Program Options. Containers----------------------- Any Array Bimap Circular Buffer Dynamic Bitset Intrusive Multi-Array Multi-Index Pointer Container Tuple Unordered Variant Functional Programming----------- Bind Functional Lambda Member Function I/O------------------------------ Filesystem Format IO State Savers Iostreams Serialization Math----------------------------- Accumulators Disjoint Sets Interval Math Math Common Factor Math Octonion Math Quaternion Math/Special Functions Math/Statistical Distributions Random Rational uBLAS Memory Management---------------- Pool Smart Ptr Metaprogramming------------------ Call Traits Compressed Pair Concept Check Enable If Function Types Fusion MPL Operators Parameter Preprocessor Property Map Proto Statechart Static Assert Type Traits Typeof Networking----------------------- Asio Text processing------------------ Regex Spirit String Algo Tokenizer Xpressive Others--------------------------- Assign CRC Conversion Date Time Exception Foreach Function Functional/Hash GIL Graph In Place Factory, Typed In Place Factory Interprocess Iterators Min-Max MPI Numeric Conversion Optional Program Options Python Range Ref Signals System Test TR1 Thread Timer Units Utility Value Initialized Tribool Wave Boost Internal------------------- Compatibility Config Integer

AMDG Kevin Sopp wrote:
There are 92 entries in the library overview now (http://www.boost.org/doc/libs). I believe this is quite intimidating for a new user. I have come up with a scheme of grouping things (I don't claim it is perfect and I put libraries that I wasn't sure about into "Others"). Each library should only appear once even if that one category doesn't describe the library's purpose perfectly. The "Others" section could be subdivided further, i.e. Concurrency and Time categories come to mind but I didn't deem that necessary.
http://www.boost.org/doc/libs/1_37_0/libs/libraries.htm ? In Christ, Steven Watanabe

On Thu, Nov 6, 2008 at 11:54 AM, Steven Watanabe <watanabesj@gmail.com> wrote:
How do you browse there? I wasn't able to from http://www.boost.org/doc/libs but I could just be blind (or it could be the serifed fonts on a webpage). --Michael Fawcett

AMDG Michael Fawcett wrote:
On Thu, Nov 6, 2008 at 11:54 AM, Steven Watanabe <watanabesj@gmail.com> wrote:
How do you browse there? I wasn't able to from
You don't, AFAICT. These categories should be merged into http://www.boost.org/doc/libs somehow. In Christ, Steven Watanabe

on Thu Nov 06 2008, "Michael Fawcett" <michael.fawcett-AT-gmail.com> wrote:
On Thu, Nov 6, 2008 at 11:54 AM, Steven Watanabe <watanabesj@gmail.com> wrote:
How do you browse there? I wasn't able to from
I always go to http://www.boost.org/libs, but if that page isn't browseable-to, it's a problem. -- Dave Abrahams BoostPro Computing http://www.boostpro.com

On Thu, 06 Nov 2008 08:54:33 -0800, "Steven Watanabe" <watanabesj@gmail.com> said:
AMDG
Kevin Sopp wrote:
There are 92 entries in the library overview now (http://www.boost.org/doc/libs). I believe this is quite intimidating for a new user. I have come up with a scheme of grouping things (I don't claim it is perfect and I put libraries that I wasn't sure about into "Others"). Each library should only appear once even if that one category doesn't describe the library's purpose perfectly. The "Others" section could be subdivided further, i.e. Concurrency and Time categories come to mind but I didn't deem that necessary.
http://www.boost.org/doc/libs/1_37_0/libs/libraries.htm ?
In Christ, Steven Watanabe
I think this is exactly what Kevin is looking for and I have missed it myself, but how does one navigate there? Going to http://www.boost.org/ then click on Documentation goes to http://www.boost.org/doc/ then click on Libraries goes to http://www.boost.org/doc/libs or click on 1.37.0 - Current Release goes to http://www.boost.org/doc/libs/1_37_0 but I don't see any link to go to http://www.boost.org/doc/libs/1_37_0/libs/libraries.htm How does one discover this page? Regards, Andy Tompkins
participants (5)
-
Andy Tompkins
-
David Abrahams
-
Kevin Sopp
-
Michael Fawcett
-
Steven Watanabe