Be sure to document that

Check out Be sure to document that by Mike Pope<mike@mikepope.com>. Here is an excerpt:

Another instance where documentation is used to fix a design flaw:

The full article is available here.