RE: [boost] Review : format2, yet another 'printf class'

From: Beman Dawes (bdawes_at_[hidden])
Date: 2001-07-01 09:20:20

If and when format comes up for standardization (or even just Boost formal 
review) there will be many people who have not read this tread, and thus 
will ask questions like:

    Did you consider blah, blah, blah?

    Why is such and such done that way?

It is difficult or impossible to recapture rationale at a later date, so 
please try add at least some rationale to the docs.

In writing rationale, Bjarne and others often point out that "Paths not 
taken (and why)" rationale is often as important as "paths taken (and 
why)."

Even if you don't document the full reasons for doing or not doing 
everything, just knowing that various options were fully considered (and 
discussed) can be quite reassuring and helpful.

Cheers,

--Beman