来源:程序猿技术大咖
![7a96302fe4bdb028a0c84d380673f381.png](https://i-blog.csdnimg.cn/blog_migrate/6b40a290fe19c1fc0ce38b48f1d0da57.jpeg)
一、背景
写文档是程序猿进阶的一个必要步骤之一。
文档写的清楚,思路就更加清晰,也会让同事高看你一眼,多梳理业务也有很大帮助。
产品经理对需求文档基本是驾轻就熟信手拈来,但是大多数程序猿写技术文档却显得不够专业。
最近有小伙伴问怎么写技术文档,结合了多个优秀的技术文档的范例,总结了技术文档的框架。
![404b72c8d6d8abf2e5292c19eb56d774.png](https://i-blog.csdnimg.cn/blog_migrate/cc429b92b0159d209b9ed00f2ec06262.jpeg)
二、框架
话不多说,直接上干货。
2.1 技术文档的架构
![847ebd2d9bf20a22b9f5db7af0720339.png](https://i-blog.csdnimg.cn/blog_migrate/c50744a9637eb1c93e56c8e4d25789da.jpeg)
关键是能够条理清晰,然后配各种UML图,表格等。
2.2 考虑的因素
我们主要考虑:
- 我们写作的目的是啥?
- 看文档的对象是谁?
- 主要想表达什么?
- 应该表达哪些内容?
- 怎样才能更有条理?
- 怎样才更容易让读者理解?
三、推荐图书和软件
3.1 推荐图书
《大象UML》、《UML精粹》
3.2 推荐作图软件
工欲善其事必先利其器。
作UML图推荐Viso、ProcessOn、PlantUml、UmlStar、OmniGraffle等。
3.4 推荐思维导图工具
mindnode、xmind、ithougthtX等
四、思考
第二部分给出了技术文档的框架,引导我们去思考应该考虑的问题。
仅有这些还不够,实践是检验真理的标准,要去练习才能真正掌握这个框架。
另外看似有了框架啥都不是问题,照着填就完了,事实并非如此。
正如高考英语作文模板一样,框架都有了差不哪去,但是具体的内容千差万别,最终的分数还是有浮动的。
要想写好技术文档,写的更加专业还需要一些软能力,比如思维要缜密一些,画交互,画UML图的能力,画思维导图的能力的能力等,这些需要平时主动去学习和训练的。
![fb381d361f04df53924354894862fd89.png](https://i-blog.csdnimg.cn/blog_migrate/0a1efcd7365588c901d63787fe20f744.jpeg)
如果你还是不清楚如何操刀书写,不妨多看看你吗公司技术大牛、架构师、CTO等,写的技术文档,先从模仿开始。