在线客服
扫描二维码
下载博学谷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等
以上就是对程序员写好技术文档的全部指导啦,大家也别光看,动手实践才是真。
— 申请免费试学名额 —
在职想转行提升,担心学不会?根据个人情况规划学习路线,闯关式自适应学习模式保证学习效果
讲师一对一辅导,在线答疑解惑,指导就业!
相关推荐 更多
各IT岗位需要的IT职业技能有哪些?
现在的IT岗位很多大概分为了软件工程、网络工程、信息管理、多媒体设计几个方向。这里我主要针对前三个方向来说说,尤其是前两个方向。如果你在IT岗位却不了解自己的职业技能应该掌握哪些这个情况很糟糕。
11675
2019-05-21 14:26:00
软件工程师要学哪些知识?难不难?
软件工程师要学哪些知识?难不难?作为互联网行业中最重要的技术岗位,软件工程师需要学习的内容十分广泛且深入,学习难度可想而知。当然,软件工程师也并不是大家想的那样十八班武艺样样精通。比如对英语水平的要求并不高,也不一定要学习多么深奥的数学知识。下面我们一起来看看想要成为一名合格的软件工程师需要学习的具体内容。
7253
2020-04-27 17:05:16
程序员培训机构哪个好?哪家靠谱?
程序员培训机构哪个好?受疫情影响身边的小伙伴大学毕业便是失业,开始了人生的迷茫期,毕业后没有一技之长,招工作成了难题,想获得高薪不少人想入行IT行业,但需要多方面考察选择靠谱的IT程序员培训机构,遇到不靠谱的培训机构会学无所成,还打击自己学习的兴趣。
4263
2020-07-03 14:39:15
如何进阶为百万年薪的程序员?
程序员年薪百万已经很常见了,甚至年薪超过300万,500万的程序员也有不少,但大多数程序员仍然迈不过年薪30W这个坎。行业中有不少人会停滞不前甚至后退这是为什么呢?
1996
2021-04-29 10:48:50
35岁不是程序员职场中的绊脚石
35岁不是程序员职场中的绊脚石,不断学习新的技能提升个人能力才是职场通关的关键。IT职场中谈及35岁人人惶恐好似洪水猛兽,仿佛谁到35岁就要被职场更重歧视,但总有一部分人能逆流而上打破“沉睡魔咒”成为大家羡慕的佼佼者。
1365
2021-12-01 14:20:10