购买
下载掌阅APP,畅读海量书库
立即打开
畅读海量书库
扫码下载掌阅APP

原则32
使用文档标准
USE DOCUMENTATION STANDARDS

如果你的项目、组织或客户要求遵循一套文档标准,那就要遵循它。无论如何,永远不要抱怨标准,认为这是不需要的。所有我熟悉的标准,无论是政府标准还是商业标准,都提供了组织和内容方面的指导。

创新!即遵循标准,同时理智地执行。无论标准怎么规定,把你知道的应有的内容都包含进去。这意味着用清晰的语言来编写,意味着添加额外的有意义的组织层级。如果你的文档没有被要求遵循某个标准,那也至少应使用检查清单来检查是否有重大的遗漏。IEEE发布的文档标准,是我所知道的最广泛的可用软件文档标准之一。

IEEE Computer Society, Software Engineering Standards Collection ,Washington,D,C.:IEEE Computer Society Press,1993. sQYneWyu/SoRsFPvP1CICaAey68AOruA9Ydd0VI6nCzl9pv0ZrDsnxOKPdjxNVH3

点击中间区域
呼出菜单
上一章
目录
下一章
×