diff --git a/lib_guide.htm b/lib_guide.htm index 00b37a3..cb710bc 100644 --- a/lib_guide.htm +++ b/lib_guide.htm @@ -430,7 +430,7 @@ ECMAScript/JavaScript. Reasons given for banning included:

basis" by the American Heritage Dictionary.

Beman Dawes comments:  Failure to supply contemporaneous rationale for design decisions is a major defect in many software projects. Lack of accurate -rationale causes issues to revisited endlessly, causes maintenance bugs when a +rationale causes issues to be revisited endlessly, causes maintenance bugs when a maintainer changes something without realizing it was done a certain way for some purpose, and shortens the useful lifetime of software.

Rationale is fairly easy to provide at the time decisions are made, but very @@ -444,7 +444,7 @@ suggestion.  Major contributions are usually acknowledged in the documentation, while minor fixes are often mentioned in comments within the code itself.


-

Revised 09 January, 2003

+

Revised 20 February, 2003