artifacts - 您生产哪些重要的设计作品？

Question

关闭。这个问题是 opinion-based 。目前不接受答案。

---

想要改进这个问题吗？更新问题，以便 editing this post 可以用事实和引文来回答它。 .

已关闭 4 年前。

Improve this question

在您的软件开发生命周期中，您生成了哪些重要的设计工件？是什么让它们对您的实践至关重要？

我目前正在进行的项目已经制作了 8 年多了。在此期间，该 Web 应用程序得到了积极的增强和维护。虽然我们有CMMI基于适当的政策和流程，我们的部分实践得到了明确的定义，设计阶段在很大程度上被忽视了。最佳实践是什么？

Answer 1

已经参与了很多 waterfall过去的项目以及最近的许多临时和敏捷项目，我喜欢创建许多设计工件，尽管我无法充分说明它实际上取决于项目的细节(方法、团队结构、时间尺度、工具等)。

对于一个通用的、基于服务器的“企业应用程序”，我希望最低限度是这样的:

• 详细的功能设计文档(也称为规范)。一般来说，类似于 Joel 的 WhatsTimeIsIt example specification ，尽管可能有一些 UML用例图。
• 软件技术设计文档。它不一定要详细说明 100% 的系统覆盖率，但要详细说明所有关键领域并包含所有设计决策。作为一个 UML 狂热者，很高兴看到大量类似包图、组件图、关键功能类图的图片，并且可能还添加了一些序列图以进行良好的测量。
• 基础设施设计文件。可能使用 UML 部署图进行概念设计，也可能使用网络图进行更实际的设计。

当我说文档时，以上任何内容都可能被分解为多个文档，或者可能存储在 wiki/其他一些工具上。

至于它们的用处，我的理念始终是开发团队应该始终能够将应用程序移交给支持团队，而不必交出他们的电话号码。如果设计工件没有清楚地表明应用程序做什么、如何做以及在哪里做，那么您就知道支持团队会给应用程序提供与疯狗一样的照顾和关注。

我应该提到，我并不是在证明将软件完成后从开发团队移交给支持团队的做法，这会引发各种有趣的问题；我只是说如果管理层愿意的话应该是可能的。