I had been picturing it like the "Readers' comments" on many ACS pages (e.g. the big batch on "Why Not MySQL"), though I hadn't worked through the issue of what happens when suggestions for changes get migrated into the newer release of the documentation. I do also like the idea of a list of tips or gotchas to keep in mind (like "if you are installing the current (as of now) OpenACS, you probably want to disable pulldown menus, because they seem to be busted and break non-intuitively (at least for me starting out)". In a way, the things that prompted me to comment do count as "Bugs against the docs" and thus fodder for SDM, true.
