Simberon Design Minute
 

Documenting Base Changes

One of the hardest things to do when you're upgrading a Smalltalk application from an older version of the base Smalltalk to a newer one is to move the base changes forward to the new version. If possible, it's best to avoid making base changes in the first place, but sometimes it's unavoidable. If you must make base changes, then it's best to document these changes in terms of the feature they provide. If you have several methods that work together to add a feature to the system, then these methods must be moved together. It's very useful to know why the change was made and what other changes were made to support the same feature. This documentation will help you later when you upgrade again.

Download