如何才能写出好的软件设计文档? 软件设计文档模板( 三 )


那么,我们如何评价一个设计文档的成功呢?
我的同事Kent Rakip对这个问题的回答是:如果能获得正确的ROI,那么设计文档就是成功的 。换句话说,一份成功的设计文件可能会导致:
你花了五天时间写设计文档,这迫使你思考技术架构的不同部分 。
您从评审人员那里得到反馈,并且知道架构的某些部分具有更高的风险 。
为了降低项目的风险,您决定先解决这些问题 。
3天后,你发现这些问题要么是不可能的,要么比你原来想象的要难很多 。
你决定停止这个项目,去做其他工作 。
本文开头我们说过,设计文档的目的是为了保证工作的正确完成 。在上面的例子中,因为设计文件,你只用了8天而不是几个月就决定停止项目 。在我看来,这似乎也是一个非常成功的结果 。