RE: [boost] Re: [function types] Formal Review begins today.

From: Brian Braatz (brianb_at_[hidden])
Date: 2005-06-07 14:12:26

> -----Original Message-----
> From: boost-bounces_at_[hidden]
[mailto:boost-bounces_at_[hidden]]
> 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.