软件设计说明练习

Question

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

你如何处理大型CSCI？

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

你做了什么剪裁？

Answer 1

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

Answer 2

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

Answer 3

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

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

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