课程咨询: 400-996-5531 / 投诉建议: 400-111-8989
认真做教育 专心促就业
随着互联网的不断发展,越来越多的人都在学习计算机编程开发技术,而今天我们就简单来了解一下,软件开发设计文档如何制作。
约束度
影响软件设计和设计文档形状的主要因素之一就是方案空间的约束度。
极端的一个例子就是“绿地软件项目”,我们都知道目标,而且解决方案可以是任何有意义的方案。这样一个文档可能涉及面很广,但它还需要快速定义一组规则,来允许对一组可控的解决方案进行细致研究。
另一方面,系统中可能的方案都定义得很好,但是完全不清楚如何将它们组合起来实现目标。这可能是一个很难更改的遗留系统,而且它不是按照你希望的样子设计的,或者是一个程序库设计,需要在宿主编程语言的约束下运行。
在这种情况下,你也许能列举出相对容易做的事情,但你需要费些心思将这些事情组合起来,从而实现目标。可能有很多方案,但没有一个是非常好的,因此,这样一个文档应该聚焦于根据所有确定的权衡点来选择佳方案。
可供考虑的备选方案
本节列出了能合理实现类似结果的备选设计。重点应该放在每个设计所做的权衡,以及这些权衡如何导致选择这个设计的决定,而这正是这个文档的要主题。
虽然简略介绍终没有被选中的方案也没有什么,但是本节会非常明确地展示为什么被选中的方案是针对项目目标的佳方案,以及读者可能想知道的,为什么其它方案提供的权衡针对目标方案是不太理想的。
交叉关注点
在这里,你的组织可以确保像安全性、隐私性、可观测性等跨领域问题被纳入考虑范围。这些通常都是相对短的部分,解释了设计如何影响这些关注点以及如何解决这些关注点。团队应该将这些关注点标准化。
由于它们的重要性,谷歌项目需要有一个专门的隐私设计文档,并且有专门的隐私和安全审查。虽然这些审查只需要在项目启动时完成,但好尽早与隐私和安全团队接触,以确保设计从一开始就将这些考虑在内。对于这些主题的专用文档,中心设计文档当然可以只引用它们,而不是详细介绍。
设计文档的长度
设计文档需要足够丰富凝练,以便忙碌的人可以真正阅读。一个比较大的项目佳长度是10-20页。如果你的文档太长,好将问题分解成多个可控的子问题。值得一提的是,写一份1-3页的“迷你设计文档”是绝对可行的。这对于敏捷项目中的增量改进或子任务特别有帮助——你仍然可以像处理一个长文档那样处理所有步骤,只需要保持简洁并且聚焦于一个有限的问题集。
【免责声明】:本内容转载于网络,转载目的在于传递信息。文章内容为作者个人意见,本平台对文中陈述、观点保持中立,不对所包含内容的准确性、可靠性与完整性提供形式地保证。请读者仅作参考。更多内容请加danei0707学习了解。欢迎关注“达内在线”参与分销,赚更多好礼。