Question

即使软件指南的目的不是为了详细解释软件做什么，也有助于扩展语境、总结软件的主要功能。

意图

这部分让你总结系统的关键功能是什么。如果它们对架构很重要，还能解释为什么，就让你可以在系统的功能切片（用例、用户故事等）之间建立明确的链接。功能性概览应该回答下面几类问题。

系统实际上做什么是否清楚？

哪些特性、功能、用例、用户故事等对架构是重要的，原因是否清楚？

重要的用户是谁（角色、参与者、人物等）以及系统如何满足他们的需求是否清楚？

上述已用于塑造和定义架构是否清楚？

另外，如果你的软件自动化了业务流程或工作流，功能试图应该回答如下问题。

从流程的角度系统做什么是否清楚？

系统的主要流程和信息流是什么？

结构

如果有文档的话，无论如何都要参考；我的意思是功能规格、用例文档或者甚至用户故事清单。它对总结业务领域和系统提供的功能往往很有用。再次，图表很有帮助，你可以使用一个UML用例图或一组简单的线框图展示用户界面的重要部分。无论哪种方式，记住这部分的目的是提供一个概览。

另外，如果你的软件自动化了业务流程或工作流，你可以用流程图或UML活动图展示流程中较小的步骤，以及它们如何相互组合。这对突出进程交叉或合并等的并行、并发方面特别有用。

动机

用图来提供一个概览，这个部分不一定需要很长。语境部分总结了软件如何融入已有的环境，这个部分则描述了软件实际上做什么。再次，这是关于提供一个总结以及设定场景，而不是全面地描述每一个用户/系统交互。

受众

直接开发软件的团队内外的技术和非技术人员。

是否必须

是，所有软件指南都应该包含对软件所提供功能的总结。