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
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.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk