软件设计说明实践

Question

在编写一行代码之前，有多少人实际编写了SDD文档？

你如何处理大型CSCI？

您对SDD内容使用什么标准？

你做了什么剪裁？

Answer 1

我当然有。历史上和最近的项目 多年前，我曾在组织中工作，模板就是一切。 然后我在其他模板更宽松或不存在的地方工作，或者不适合我正在进行的项目 现在，软件设计的内容几乎取决于我需要描述的内容，以便将想法传达给观众 “在编写单行代码之前”不会有太多细节。我在开始编码之前编写的文档旨在让我们了解我们需要构建到受影响的团队和高级管理层的内容，以便他们引入高级架构，功能，技术，风险和范围。最后两个非常重要。剩下的就是向其他团队展示你需要与他们交流的地方，并让管理者留下一个挥之不去的想法，即发生很酷的事情。

Answer 2

大多数大型软件公司都有自己的做法。例如，摩托罗拉有关于软件开发过程各个方面的详细文档。每种类型的文档都有标准模板。拥有严格的标准可以有效地维护大量文档并将其与不同的工具集成。每个文件从特殊文件跟踪系统获得跟踪号。他们甚至有自动需求跟踪系统（上次我看到它处于早期开发阶段） - 您可以说哪条代码行与给定的需求\设计指南相关。

Answer 3

我认为大多数编写SDD文档并使用CSCI等术语的人必须使用特定的软件开发方法，并且很可能正在为一些严肃的政府客户工作。他们通常会非常认真地对待他们的准备工作，并且在开始任何开发之前，文件已准备好并获得批准。

在敏捷过程中，开发和设计文档可以并行开发。这意味着将要进行大量的重构，但最终通常会提供非常好的结果。

在更正式的流程（如RUP）中，SAD文档主要是在基于团队研究的精化/原型设计阶段创建的。