有多少人在编写一行代码之前实际编写了 SDD 文档?
您如何处理大型 CSCI?
您对 SDD 内容使用什么标准?
你做过什么剪裁?
我当然有。历史上和最近的项目。
几年前,我在模板就是一切的组织中工作。然后我在其他模板松散或不存在或不适合我正在从事的项目的地方工作。
现在,软件设计的内容几乎取决于我需要描述的内容,以便将这个想法传达给观众。
“在编写一行代码之前”不会有很多细节。我在开始编码之前制作的文档旨在让受影响的团队和高级管理人员了解我们需要构建什么,以便他们介绍高级架构、功能、技术、风险和范围。最后两个真的很重要。剩下的就是向其他团队展示你需要与他们交流的地方,并让经理们留下一个挥之不去的想法,即正在发生一些很酷的事情。
大多数大型软件公司都有自己的做法。例如,摩托罗拉对软件开发过程的各个方面都有详细的文档。每种类型的文档都有标准模板。拥有严格的标准可以有效地维护大量文档并将其与不同的工具集成。每份文件都从专门的文件跟踪系统获得跟踪号。他们甚至有用于自动需求跟踪的系统(上次我看到它处于早期开发阶段)——你可以说哪一行代码与给定的需求\设计指南相关。
我认为大多数编写 SDD 文档和使用 CSCI 等术语的人必须使用特定的软件开发方法,并且很可能正在为一些严肃的政府客户工作。他们通常倾向于非常认真地对待他们的准备工作,并且在任何开发开始之前就已经准备好并批准了文件。
在敏捷过程中,开发和设计文档可以并行开发。这意味着需要进行大量重构,但最终通常会产生非常好的结果。
在更正式的流程(如 RUP)中,SAD 文档主要是在基于团队研究的细化/原型设计阶段创建的。