过去几年中一个主要的进步是软件品质标准(quality standards)的出现,像是ISO认证,
”2167”标准和来自美国国防部的后继版本,软件工程学会的能力成熟度模型(CMM).也许因为它们从来自其它的训练模型里跳出的,所以它们趋向于指定详细的书面材料.这些标准中的一些通过加强自包含文档原则在软件品质上有着更好的效果(这超越了以防后面的麻烦单纯为管理人员提供一个机制的出发点).
This book will draw on the Self-Documentation principle to define a method for documenting classes — the modules of object-oriented software construction — that includes the documentation of every module in the module itself. Not that the module is its documentation: there is usually too much detail in the software text to make it suitable as documentation (this was the argument for information hiding). Instead, the module should contain its documentation.
