美文网首页
领域驱动设计-书面设计文档

领域驱动设计-书面设计文档

作者: 东南枝下 | 来源:发表于2021-08-24 22:23 被阅读0次

一旦文档的形式变得一成不变,往往会从项目进展流程中脱离出来。它会跟不上代码或项目语言的演变

文档应作为代码和口头交流的补充

文档不应再重复表示代码已经明确表达出的内容。代码已经含有各个细节,它本身就是一种精确的程序行为说明。

文档应该着重说明含义,以便使人们能够深入理解大尺度结构,并将注意力集中在核心元素上。当编程语言无法直接明了地实现概念时,文档可以澄清设计意图。我们应该把书面文档作为代码和口头讨论的补充

文档应当鲜活并保持最新

观察文档与UBIQUITOUS LANGUAGE之间的交互,如果设计文档中使用的术语不再出现在讨论和代码中,那么文档就没有起到它的作用。或许是文档太大或太复杂了,或许是它没有关注足够重要的主题。

通过将文档减至最少,并且主要用它来补充代码和口头交流,就可以避免文档与项目脱节。根据UBIQUITOUS LANGUAGE及其演变来选择那些需要保持更新并与项目活动紧密交互的文档。

相关文章

网友评论

      本文标题:领域驱动设计-书面设计文档

      本文链接:https://www.haomeiwen.com/subject/iyujiltx.html