通过仔细观察一个特定的柠檬,你可以非常有效地描述它。同时,你的描述准确无误,包含很多细节,而且效率很高,因为你不必描述那些一般特征。
文档与系统严重不匹配,当系统的知识不易获得时,我们便称这种系统是“遗留系统”。它们体现了我们所谓的“文档破产”。
你并不需要在第一次尝试时就完成所有文档工作。它应该随时间演进。
不经常变更的知识(即常青内容)
系统的文档应该将一件事解释清楚,而不是糟糕地解释十件事情(这个文档已经有对应的真正系统了)
总体来说,本书的主要论点是,如果你从文档开始,那么最后会得到更好的设计。
产品负责人、开发人员和测试人员坐下来讨论正在开发的系统应该做的事情。产品负责人会描述用户故事。开发人员和测试人员会提出问题(并提出建议),直到他们认为自己可以回答这个基本问题:“我怎么知道这个故事已经完成了?”
因此,请不要犹豫,花些时间和精力来学习稳定的知识吧。尤其是业务领域知识和软件架构的基础知识是常青内容,特别值得学习。