-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of David Abrahams
"Brilliance is a mastery of the obvious" <*>>> and documentation
should
seek to brilliantly expose the obvious over complicated subjects.
[David Abrahams Writes:]
Another thing: the author of documentation should (usually) disqualify him- or herself from making judgements about understandability and especially approachability. The problem is that once you understand it, it's very hard to see the places where it fails to communicate to someone who doesn't.
[Brian Braatz Writes:] :) " The problem is that once you understand
it, it's very hard to see the places where it fails to communicate to someone who doesn't."
A RESOUNDING YES!!!!!!- And thank you David. This sentence is worthy of printing out and hanging on my wall. Or maybe I should make tee-shirts and hand them out at conferences. Or better yet, I could have stickers made and hand those out. Then anytime someone sees some documentation that fails to make sense to normal humans, they can slap the sticker on it and hand it back to the author.