专注于互联网--专注于架构

程序设计文档:改进程序的文档

文档是对总目标、各组成部分的间关系、设计策略、实现过程历史数据等介绍说明和补充文档对提高可理解性有着重要作用即使是个十分简单要想有效地、高效率地维护它也需要编制文档来解释其目及任务而对于维护人员来说要想对编制人员意图重新改造并对今后变化可能性进行估计缺了文档也是不行因此为了维护人们必须阅读和理解文档那种对文档价值估计过低看法是由于过低估计了用户对改变要求而造成 现在人们已经认识到好文档是建立可维护性基本条件它作用和意义有 3点: (1)文档好比没有文档容易操作它增加了可读性和可使用性但不正确文档比根本没有文档要坏得多 (2)好文档意味着简洁、风格致、且易于更新 [阅读全文] [PDF]