设为首页 加入收藏

TOP

通向架构师的道路(第二十六天)漫谈架构与设计文档的写作技巧(二)
2018-03-23 08:53:25 】 浏览:402
Tags:通向 架构 师的 道路 第二十六 漫谈 设计 文档 写作 技巧
立体的色块来展现,带给观看者强烈的视觉冲击,架构师的功底基本可以集中体现在这三套图中,这三套图同时也起到了“先声夺人”吸引观众的眼球,注意力的作用(那边的女孩看过来看过来,我的钞票多。。。嘿嘿嘿)
如下面这样的一个总架构图的表现手法:
对吧,暖色调,以几何或者立体的色块来展现

3.2.2 以图绘意

我这边提个问题:如何表达一个”业务规则“,如何去表达一个”工作流“,就是”业务规则“这四个字我用图怎么表达。。。工作流这三个字我用图怎么表达?大家想一下。
来,看看下面的图:
这个图一看就知道是在表达process或者说是工作流

这个图代表”规则“,规则就是一组if else if if

对吧。。。现在来个更难的,我的业务规则用的是规则引擎,且内核是jboss rulz,嘿嘿,怎么用图标达,来。。。下面给出我的答案:

对吧。。。看到了吗。。。图用来绘意,但图不能乱用,就拿这个”系统中使用了JBOSS RULZ来作为规则引擎”这个描述来说,你要画的图其实是建立在你的Hard Skill上的。

3.2.3 依照“八股文”来绘制设计图

八股文就是有条理有章矩,不管什么样的文章你按照八股文去写,写出来都是一样的层次,我们考四级英语的“写作”这一本时其实也是有“章法”可循的对吧?

那么这个设计图的画法也是有章可循的,也是有它的“八股文”样板的。

前面说了,上手三套图先声夺人,抢人二目,那么在架构设计文档中还会充质着种种模块,子模块,功能设计,功能点描述图。。。如果你也来个一概而论,那就不是先声夺人了,而是“喧宾夺主“了,呵呵呵。

这种子模块、功能设计或者是功能点描述往往往以点、线为主,以点、线来连成一个面,而面中”娄空“,如下面的样例:

 

四、如何画出准确且“漂亮”的设计图呢

七叔:You are beautiful…啊…you are beautiful…You are so handsome…啊You are so handsome…
周星星:七叔,你不要这样好吧。。。七叔。。。来人啊。。。
我在前一天即第二十五天中用来描述DbUnit的优点时用到了一套图,它们是这样的,大家还记得吧?
右边的文字,没什么稀罕的,都是配色而己,关键在于左边的这个图。。。hoho,很多人问我用的是什么工具画的?
我告诉你们,我不是美工,我其实是在“拼图”,如这幅图的制作:
我是用了以下这5幅小图标,拼制而成的:
不是这么简单的,随便画画就成了,都要花功夫的、花心思去制作的。
  • 平时自己看到好的可以表达某个意义的图片,存下来,分门别类
  • 看到人家写的好的架构文档,存下来,看看人家是怎么去描述一个功能点的
  • 多搜集一些IT上专用的图标,小图片,logo
IBM的文档是我看到过最恐怖的文档,基本上这里面的架构文档出来都一个腔调,没什么文字,都是图,连个“登录过程”都用图表达,连个“源码check in check out”的管理流程都用图表达。
保持你的图系一致及风格的一致,你可以用卡通系、商务系任何一个系的图来表达你的设计思想,但是当你的第一幅图用的就是哪个系时,你的文档中所有的图都请用这个系列,而不建议你混杂使用你的图系。

五、图文混杂的技巧

什么都不多说,上截图,大家自己去感受一下吧

今天就说这么多,希望对大家提高你的设计文档写作水平有所提高吧。

首页 上一页 1 2 下一页 尾页 2/2/2
】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
上一篇JDK 10 的 109 项新特性 下一篇通向架构师的道路(第二十五天)S..

最新文章

热门文章

Hot 文章

Python

C 语言

C++基础

大数据基础

linux编程基础

C/C++面试题目