在线客服
扫描二维码
下载博学谷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行业薪资待遇上涨快,很多传统企业转型成互联网+模式,人才需求不断扩大。北京程序员目前的平均月薪在12k左右。如果工作5年以上的程序员,其月收入基本都是在20k以上,初级程序员月薪1万元是很普遍的薪资水平。
9049
2020-03-02 15:39:10
敏捷开发如何提高工作效率?
敏捷开发应对快速变化的需求的一种软件开发能力,只要在符合价值观和原则的基础上能让开发团队拥有应对快速变化需求的能力。在团队职责上,团队内部具备完成软件交付的角色,团队所有人对软件的质量负责,开发过程由团队内部把控,业务价值团队内部快速流动,在任何环节都能及时获得反馈。
6725
2020-07-09 10:59:19
想到编程,除了高薪还有啥?
学习编程,其实最关键的不是要掌握编程的“语言”,而是要学会编程过程所用到的思考方式就是“编程思维”。
3584
2021-08-06 18:51:27
程序员为什么不爱炫富?
要说现在什么工作挣钱多,程序员绝对排得上号,沾了互联网大踏步发展的光,敲代码成了一份令人羡慕的“高薪”职业,但身边的朋友总是奇怪,为什么很多程序员的打扮都有点“寒酸”,他们总有一种把月薪五万过成月薪500的技能。
3116
2021-10-22 13:55:50
IT行业应届毕业生的简历改怎么写?
IT行业应届毕业生的简历改怎么写?包含哪些内容?简历需要注意的细节有很多,如不认真对待那么会直接减少你的面试机会。硬核简历。简历应该包含基本信息、教育背景、专业技能、工作和项目经历、自我评价等部分的介绍
3379
2022-03-02 11:09:50