David,
You're saying that all of those libraries have "here are all the wrong turns I took in developing this library" pages?
I'm not sure this exchange is going to be of any further use. You are getting defensive and sarcastic. It's not really possible to make any sweeping statements about the Boost libraries or their documentation since they are usually each developed by a different person with different backgrounds and different goals. There's nothing inherently good or bad about that--it's simply a fact. I may in unusual in that I do RTFM--or at least try. In the case of Boost documentation, I have been repeated frustrated, usually in different ways in different libraries. So, no, all those libraries I have used don't have "wrong turn" documentation. Merrill