软件技术已经取得了进步,但是我们讨论了如何构建软件过程,似乎已经停滞不前了,你会发现很多问题和争论,而现在,冲突的代码和文档也是其中之一。
开发人员足够的耐心(有关工具和心理负担,邹老师提到过),时间的投资成本(客户能够首当其冲的文档和代码同步开发进展缓慢),但更重要的是可维护性(文档胡润,同理心,以及随后的主张的理解),将挑战的匹配程度的文档和代码。
我们更希望开发人员代码理解系统的行为,与真正的系统的行为和代码为基础的练习,在这样的前提下,如何构建一个更可读的代码结构是相对容易理解,编制“完美”文档更有价值的事情。换句话说,优秀的开发人员会阅读代码而不是依赖文档来确保他们理解系统的行为。
更改人员将通知负责该文档并更新文档的人员/团队。这一变化还需要审查修订后的文件。所有这些都可以通过工作流进行规范化。作为项目发布的一部分,文档需要更新和完成,以发布新版本。
综上,由于这些文档是指导性的,所以最终的实现可能与文档不一致。如果需要,在项目完成之后,实际的实现应该被重写。