Joel de Guzman <joel@boost-consulting.com> writes:
Oops
Introduction: - Parts of the introduction are a bit too colloquial for my taste, in particular, the paragraph.
"Hmmm, kinda reminds us of STL right? Right! Can you imagine how it would be like if you used STL without the algorithms? Everyone will have to reinvent their own algorithm wheels."
Ok. How about if we separate the tutorial from the reference manual proper as others have suggested? That way, we can keep the tutorial somewhat colloquial and present a formal reference manual after.
I'm sure some people like that approach, but for me that is much too chatty even for a tutorial. All the extra language is a distraction from what is essential, and I find it somewhat annoying... not to mention the fact that many many people use the STL without the algorithms! :) -- Dave Abrahams Boost Consulting www.boost-consulting.com