在线客服
扫描二维码
下载博学谷APP扫描二维码
关注博学谷微信公众号
程序员如何写好技术文档?一个合格的程序员对此应该是驾轻就熟,如果你还不会写也没关系,毕竟不是每个人都能写好文档,现在赶紧来看看小编整理的写好技术文档指导教程吧!
一、基本原则
1、结构清晰
所谓结构清晰就是用户能马上找到自己要查找的知识点在哪,分类清晰。有些文档爱用模棱两个的词,比如“1. 常见问题”,“2. 热点问题”,"3. 高频问题"。我有十万火急的事情,你来告诉我我到底是要先看哪个?
2、循序渐进
先从最简单的开始,然后慢慢深入。比如我们学习Java,一开始Hello World都还没跑起来就先说配置文件要怎么写,Java一大堆的xml配置文件老司机都看的眼花缭乱更别说新手,这种文档让人直接从想了解到放弃。
3、引人入胜
把能吸引人的地方展示出来,比如Unity 3D默认就带一个设计精良的游戏Demo,一看到就有学习的兴趣。如果提供的是Web API除了有详细的文档外还应该直接能在浏览器里模拟出一个可调用的Demo,而不是看着API文档还需要不停的尝试,不停的踩坑才能调通。
二、考虑因素
我们写作的目的是啥?
看文档的对象是谁?
主要想表达什么?
应该表达哪些内容?
怎样才能更有条理?
怎样才更容易让读者理解?
三、推荐图书和软件
1、推荐图书
《大象UML》、《UML精粹》
2、推荐作图软件
工欲善其事必先利其器。
作UML图推荐Viso、ProcessOn、PlantUml、UmlStar、OmniGraffle等。
3、推荐思维导图工具
mindnode、xmind、ithougthtX等
以上就是对程序员写好技术文档的全部指导啦,大家也别光看,动手实践才是真。
— 申请免费试学名额 —
在职想转行提升,担心学不会?根据个人情况规划学习路线,闯关式自适应学习模式保证学习效果
讲师一对一辅导,在线答疑解惑,指导就业!
相关推荐 更多
软件工程师待遇怎么样?怎样成为软件工程师?
互联网技术大大改善了我们的生活,作为互联网脊柱人才的软件工程师功不可没。那软件工程师待遇怎么样呢?是否真如网络传播的高薪呢?目前薪资水平能达到多少呢?
6134
2019-08-07 18:18:50
什么样的IT程序员更受欢迎
提到程序员,很多人会觉得特别高大上,而不少程序员则以码农自嘲。虽然程序员比较“吃香”,但是现在计算机专业的毕业生和非计算机专业出身的程序员已经很多了,就业市场竞争还是很激烈的。想要在这个行业里立稳脚跟甚至脱颖而出,需要一些特质。
3415
2020-05-08 09:58:19
代码中if…else过多怎么办?解决方案汇总
if…else是我们经常会使用的基础语法,但是在代码中如果存在过多的if…else,将会很大程度影响代码的可读性和可维护性。那么代码中if…else过多怎么办?本文为大家汇总了解决这个问题的五种方案,下面我们来逐一看看吧!
5343
2020-05-12 14:45:50
2020年IT行业发展前景如何
随着我国网络技术迅猛发展,企业对IT人才的需求量也在不断增加,但现在还是缺乏许多高端IT人才。大量IT学子因为技术不够纯熟会遇到找工作难的问题,这就是因为我国低端的技术人员已经过剩,但有水平、有独立项目运作能力的人才还处在极度缺乏的状态。
4740
2020-06-05 14:13:54
传智教育博学谷赋能在职人群,推出系列公开课及大咖聊技术
传智教育博学谷重磅免费推出 “职场升级系列公开课”和“大咖聊IT”两大活动,通过聚焦解决职场发展瓶颈,传授前沿技术应用能力,为传智教育旗下黑马程序员和博学谷两大子品牌的老学员赋能,让他们的职场能力得以提升,平稳度过“职场瓶颈期”。
1829
2022-09-29 16:42:09