《活文档:与代码共同演进》读书笔记

通过仔细观察一个特定的柠檬,你可以非常有效地描述它。同时,你的描述准确无误,包含很多细节,而且效率很高,因为你不必描述那些一般特征。

文档与系统严重不匹配,当系统的知识不易获得时,我们便称这种系统是“遗留系统”。它们体现了我们所谓的“文档破产”。

你并不需要在第一次尝试时就完成所有文档工作。它应该随时间演进。

不经常变更的知识(即常青内容)

系统的文档应该将一件事解释清楚,而不是糟糕地解释十件事情(这个文档已经有对应的真正系统了)

总体来说,本书的主要论点是,如果你从文档开始,那么最后会得到更好的设计。

产品负责人、开发人员和测试人员坐下来讨论正在开发的系统应该做的事情。产品负责人会描述用户故事。开发人员和测试人员会提出问题(并提出建议),直到他们认为自己可以回答这个基本问题:“我怎么知道这个故事已经完成了?”

因此,请不要犹豫,花些时间和精力来学习稳定的知识吧。尤其是业务领域知识和软件架构的基础知识是常青内容,特别值得学习。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容