10. Object Model Documentation
The basic tool for the manipulation of reality is the manipulation of words. If you can control the meaning of words, you can control the people who must use the words.
—Philip K. Dick
Documenting Your Work
Pictures may be worth a thousand words, but clients pay for words: words telling them what the system will do, what portions will be built now, and what portions will be built later. Developers need words, too: words describing collaboration rules, property values, and service definitions. This final chapter discusses creating supplementary documentation for an object model.
The “functional spec” is the traditional document for writing up the features and functionality of a system. ...