架构设计【说文档】－ 系列 1： 为什么要写【架构文档】？

2019独角兽企业重金招聘Python工程师标准>>>

本章主题：

            回答一些与文档有关的问题。对于文档的重要性有思想上认知。

阅读人群：

            目前正在写文档的Coder。

1： 为什么一定要写文档，写好架构设计的文档，哪怕当前的系统在你看来非常简单

            有文档有助于不同利益相关的人员进行有效的沟通。

            有文档的架构可以在将来人员流转以后，追溯产品的上下文，

            有文档的架构可以交流自身对于架构的各种观点

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

            有文档的架构可以提醒架构师，真切的梳理好背后架构的逻辑，以至于达到理性的认识。

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

            

2：写文档之前一些有必要的思考？

        1 ：识别 利益相关者，清晰的知道文档的受众是谁？

        2：选择观点，写作的切入点。

        3： 如何组织？

        4:  添加和删除是否方便？

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

    答：

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

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

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

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

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

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

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

    答：

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

        实现层级。

        交叉关注。

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

        答：

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

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

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

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

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

         

转载于:https://my.oschina.net/infiniteSpace/blog/336453