第五周 继续文档的一些细节

文档这部分的学习是先从一个个的小细节入手，如用例图、流程图、时序图......，把工具箱丰满起来，最后再根据需要把他们都组合在一起，形成一个完整的输出文档。

课程结构也非常清晰有规律，先介绍这个工具的意义是什么，看一些案例示图，然后“一起画”。会一边看着二爷画，自己用纸和笔跟着，发现有些地方确实不如软件更方便。软件有一些快捷键、以及线的地方更好调整。

对自己的启发是，在工作沟通会更容易想到“诶，说不清楚，那我给你画个图吧”，这样的方法来确认双方对文档的框架结构和一些细节达成一致。

在小公司的数据分析/算法实习岗中，也会涉及到写模型文档，在表达模型步骤时，也可以用流程图画一下，方便行方业务人员理解和公司的 ETL 人员进行取数/模型的直接应用。

刚买的《以图代言》很开眼界，作者用漫画和文字结合的方式就讲明白了图的力量。

流程图是对用例的补充，促使我们思考用例里的功能具体是如何实现的。在画图中，不必拘泥于学院派教条的规矩，每个箭头都用到完美无误，重点还是要便于理解。怎么方便怎么来。有一些小技巧可以让图看起来更美观一点：加个白底/45°。

理科背景让我一看到流程图的分支、菱形框就想到 if、for 判断/循环语句。

时序图在流程图基础上，进一步明确了角色和时间顺序及大致的区间（时间长度）占用。

状态图很适合把复杂的活动，清晰的展开，然后会更加明确实体之间的逻辑关系。一个 A 对应几个 B：{(0...n)，(1...n)，(0,1), (0,0)}。