Re: [boost] [Getting Started] 3rd revision - attn. library authors

From: David Abrahams (dave_at_[hidden])
Date: 2006-12-14 12:31:22

Edward Diener <eldiener_at_[hidden]> writes:

> Sorry, but as a former literature major I can't help it:
>
> "Start with libs/index.html if you're looking for the whole enchilada."
>
> should be in proper English
>
> "Start with libs/index.html if you're looking for the beginning of the 
> entire documentation."

As an inveterate stickler for precise criticism, I have to object.
What I wrote is proper English; it just happens to use a
colloquialism.  Informal?  Yes, but that's another matter.  My writing
tends to be very dry, and I think it can only benefit from the rare
injection of levity.  This phrase doesn't hurt unless it is wildly
out-of-step with the tone of the rest of the document, or is going to
confuse people who aren't familiar with our slang.  IMO, in context,
"the whole enchilada" is sufficiently obvious, but if non-native
speakers contradict me I'll happily remove it.  For that matter, if
there is a general outcry against the phrase for any reason, I'll
happily remove it.  I don't want take it out on the grounds that it's
improper, because I don't agree with the premise.

> Otherwise the document is a very good introduction to Boost, and a great 
> addition to the online documentation regarding the library. 
> Congratulations !

Thanks :)

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com