INDEX | SITEMAP | SEARCH | LINKS | UPDATES | BLOG | MESSAGEBOARD | EMAIL | HOME

Current Site Revision Status (Updated Monthly)

greg goebel / sep 10

* This document gives the current status of document revisions on this site. The list has two parts, with the first part giving the history of document revisions and the second part listing documents on the front of the queue for updates.

Please be aware that even minor changes require a complete proofreading and inspection of a document, and assignment of a new revcode. OK, I will change minor but really embarrassing typos without going through all that rigamarole, but only when it's absolutely urgent. Making minor changes in a document without performing proper quality assurance will eventually wreck it, a phenomenon software engineers call "bit rot". On the other hand, if proper quality assurance is performed, over time the quality of the document improves. In addition, when a document is updated, it is usually inspected to see if any improvements or additions are possible.

A three-digit revcode is used for documents. A major overhaul gets a revcode with the high digit incremented, for example "v4.0.0"; a substantial set of changes gets a revcode with the middle digit incremented, for example "v4.1.0"; a minor change gets a revcode with the low digit incremented, for example "v4.1.1".

[1] SITE REVISION HISTORY
[2] PRIORITY UPDATES

[1] SITE REVISION HISTORY

* This section provides a queue of current documents with their last revision dates, organized by month backwards from the present.

The plan is to have a two-year revision cycle on this site. Documents on the bottom of the list have highest priority for review, while those at the top of the list have the lowest. However, a document's priority may be raised above its normal level if the defects are severe or important new information has emerged.

Of course, the severity of a bug is something of a subjective judgement. I have noticed that the loudest complaints I get are usually over the most trivial bugs. In any case, current document revisions include:

BACK_TO_TOP

[2] PRIORITY UPDATES

* This section provides a list of the documents for which updates are planned. There's no particular priority; I go through the entries in section 1 every now to create a list of the documents I want to update, then work through that list. Once I've cleaned it out, I start the cycle over again.

BACK_TO_TOP

INDEX | SITEMAP | SEARCH | LINKS | UPDATES | BLOG | MESSAGEBOARD | EMAIL | HOME