如何撰写高质量的软件架构文档：迈向优秀架构师的关键步骤

假设你对项目管理、系统架构有兴趣，请加微信订阅号“softjg”，增加这个PM、架构师的大家庭

问：为什么要编写软件架构文档，它的优点是什么？

答：

有文档的架构有助于不同利益相关者之间进行有效的沟通。

有文档的架构能够提供追溯其它工作产品的上下文。

有文档的架构能够传达可供选择的架构解决方式。

有文档的架构有助于从一个现有架构转换到一个新架构计划的计划编制。

有文档的架构通常能通过识别组成架构的元素及它们之间的依赖性来帮助编制计划。

有文档的架构能够提醒架构师在其所作的某些决定背后的基本原理。

有文档的架构有助于识别哪些资源可重用以及可重用的时机。

有文档的架构有助于架构的评估。

问：编写软件架构文档的步骤是什么？

答：

识别利益相关者组。

选择视点。

创建工作产品。

给架构描写叙述打包。

问：编写软件架构文档的视点有哪些？

答：

视点分为两类，各自是基础视点和交叉视点。当中基本视点的类型有四种，分别为：

（1）功能性视点：它关注支持系统功能性的元素。

（2）部署视点：它关注支持系统分布的元素。

（3）需求视点：为形成架构的系统需求提供说明，它包含功能性需求、品质和约束。

（4）确认视点：为系统提供必需的功能、展示必需的品质和适应定义的约束提供说明。

交叉视点是从某一特定功能的视点出发，与基础视点交叉综合关注的元素，下图为一交叉视点的样例。

问：软件架构通常要描写叙述框架，应该从哪些角度去描写叙述？

答：

多重视图和场景视图的使用。

实现层级。

交叉关注。

问：软件架构的4+1视图模型是什么？

答：

软件架构的4+1视图是指逻辑视图、开发视图、过程视图、物理视图和场景（视图）。

逻辑视图是设计的对象模型。

过程视图获取设计的并发和同步方面的信息。

开发视图描写叙述的是软件开发环境中的软件静态组织。

物理视图描写叙述了软件与硬件之间的映射，还反映了它在分布式方面的信息

假设你对项目管理、系统架构有兴趣，请加微信订阅号“softjg”，增加这个PM、架构师的大家庭