These are suggestions that are more or less taken from a post to the Boost Development forums a few days ago.
I feel that it would be helpful if there was a little bit of standardization in the layout/content of the documentation. A lot of the documentation implements similar ideas (one minute tutorials, introductions, reference sections), but each individual libraries documentation has the earmarks of the authors.
What could we do in the way of standardization? If we had a list of common sections for all libraries, it would be easy for all users to find what they need. Just looking for a quick reference? Go to the "One Minute Tutorial" section. Looking for the reference? Reference section. Rationale? Rationale section.
Does anyone have any thoughts on this?
Sorry for the delay.. I had a personal commitment bite me from behind, and Joaquín, who had been busy for a few weeks, gave me a laundry list of suggestions/changes for my GSoC project ;)