- 浏览: 936524 次
- 性别:
- 来自: 魔都
文章分类
- 全部博客 (745)
- MultiThread (19)
- My Plan (118)
- JavaBasic (61)
- MyInterview (104)
- InternetTechnique (5)
- ProjectConclusion (1)
- Maven (5)
- MogoDb (5)
- Hadoop (11)
- Memcached (6)
- TechniqueCollect (1)
- Ibaits (1)
- Android (34)
- ItLife (40)
- Tree (2)
- ProjectArchitect (7)
- Open Source (3)
- liunx (5)
- socket (8)
- Spring (27)
- DesginPattern (35)
- WebBasic (13)
- English (13)
- structs (1)
- structs2 (2)
- Oracle (17)
- Hibernate (2)
- JavaScript (4)
- Jdbc (1)
- Jvm (15)
- Ibatis (1)
- DataStructures (13)
- Https/Socket/Tcp/Ip (3)
- Linux (4)
- Webservice (7)
- Io (2)
- Svn (1)
- Css (1)
- Ajax (1)
- ExtJs (1)
- UML (2)
- DataBase (6)
- BankTechnique (3)
- SpringMvc (3)
- Nio (3)
- Load Balancing/Cluster (3)
- Tools (1)
- javaPerformanceOptimization (8)
- Lucene(SEO) (1)
- My Think (80)
- NodeJs (1)
- Quartz (1)
- Distributed-java (1)
- MySql (7)
- Project (4)
- junit (4)
- framework (1)
- enCache (1)
- git (2)
- SCJP (1)
- sd (1)
最新评论
-
lkjxshi:
你都这水平了还考这个证干嘛
SCJP 认证考试指南 -
钟逸华:
问的真多
百度java开发面试题(转) -
zuimeitulip:
觉得我就是这样的,从小阅读量就很少,导致现在的读的速度非常慢, ...
让读书成为一种习惯 -
DDT_123456:
我觉得你是不符合要求。问你hashmap的那个问题,你那样回答 ...
阿里面试2(转) -
jingjing0907:
刚刚写了很多读过此博客的感受,竟然没有发上去,以为我注册账号还 ...
让读书成为一种习惯
在软件开发和维护过程中,文档是必不可少的资料,它可以提高软件开发的效率,保证软件的质量,而且在软件的使用过程中有指导、帮助、解惑的作用。尤其在维护工作中,文档的重要性更是不言而喻。
本文整理了软件开发中10个最佳的文档编写实践,希望能对你的工作有所帮助。
1. 将编写文档作为开发工作中的一个重要环节(例如,占用总开发时间的10%)。在软件开发中,不能没有文档,但如果编写文档占用了大部分的时间也不合适。可以根据需要制定代码文档、需求说明文档、设计文档、测试文档、用户手册等,在制定完成后,可以通过版本控制工具或基于Web的平台来管理和共享这些文档。
2. 代码文档非常重要的。最好的方式是编写“自说明”的代码,变量、方法、类、包等名称必须是有意义的,代码流必须是清晰的。对于非常复杂的代码段,可以包含简短的注释行。还可以在代码中添加相关的标签或注释,自动生成Javadoc文档。
3. 对于将来接手的开发者,可以为他们准备一些简短、实用的设计文档,其中需要包含关键设计特性和UML图等,无需出现大量不必要的信息。
4. 需求/问题/未交付项目/功能点跟踪文档也相当重要。使用跟踪工具将会使这项工作更加有效率,这些工具可以帮助你完成一些像快速搜索、编辑等方面工作,并可以生成纯文本文档。
5. 测试跟踪文档也很重要。可以使用一些工具来记录测试场景和测试结果,并附上一些相关的需求。这样,可以很容易地监视软件的功能状态。
6. 文档是一个持续性的工作,开发人员应该随时更新或重新生成这些文档的最新版本,直到开发进程结束。如果一个文档不是最新的,那么它毫无价值。
7. 对于文本形式的文档,版本相当重要。每一个新的文档,必须有一个新的版本号(版本号由公司的版本管理策略来定),还需要将这些信息记录在版本跟踪表中,以便更好地跟踪。
8. 有一个统一的文档模板。文档的页眉、页脚、标题、字体大小必须一致,这样可以增强可读性。还可以做得更好,比如加上封面、目录、图表、词汇表等。
9. 还需要注意文档格式、使用的语言、错别字等。输入错误、不一致的表格大小、缩进等问题,可能会分散阅读者的注意力。
10. 将项目中学到的经验记录下来,并分享给其他人。开发者在每个项目中都可能会得到一些实用的经验(比如架构、代码、配置等),而这些经验信息不会出现在标准的开发文档中。开发者要不断积累并分享这些经验,这可能会加快当前的开发进度,而且对于将来做一些有挑战的工作或者重复性的工作,会有很大的帮助。
发表评论
-
2015年4月份学习计划
2015-04-02 22:52 10302015年4月份学习计划 第一周(4.2-4.5) ... -
CVCV
2015-03-02 18:01 940menards Menards是美国第三大家居装饰和用品 ... -
20件程序员必须知道的事
2015-02-28 17:29 848我最近看了一本叫做《the 97 Things a Pro ... -
卓越程序员和优秀程序员有哪些区别?
2015-02-28 09:51 834卓越程序员和优秀程序 ... -
为什么有些人工作是痛苦的?
2015-01-07 16:06 675身边一个朋友,每天工作内容多但是都不复杂,但都是些特别容易出 ... -
2014年12月份学习计划
2014-12-21 21:45 711第三周(12.22-12.28) 结合官网来看 12 ... -
11个小技巧提高程序员工作效率,小习惯更重要(转)
2014-12-06 22:18 913“吃苦耐劳”真的是优良品质吗,与你怎么做相比,老板们应该更关 ... -
箴言(转)
2014-11-05 00:14 4701、每天晚上12点之前睡觉,早上8点起床 2、努力学 ... -
2014.11月份学习计划
2014-11-05 00:13 559hadoop 学习计划 hadoop中级 (11.5 ... -
22条日常技巧助程序员提高工作效率、节约时间(转)
2014-10-28 14:14 749我一直在测试和调整各 ... -
浅谈、男人需要完成的事! (转)
2014-10-28 14:13 8341,事业永远第一 ... -
提升程序员身心健康和工作效率的装备有哪些?(转)
2014-10-22 12:21 744曾经有很长的一段时间一直在学习和探索提升工作效率& ... -
优秀软件工程师必备的7大特性(转)
2014-10-22 10:23 812不是每一个程序员都 ... -
程序猿的十一条浮躁表现
2014-09-15 23:40 7021. 不能静下心来坚持读完一本有深度的书。 2. ... -
30岁后你会站在哪里?(转)
2014-06-08 20:15 870http://www.oschina.net/ques ... -
Java互联网工程师要具备哪些技能(转)
2014-02-26 20:58 8351.Core Java, 就是Java基础、JDK的类库,很 ... -
如何做到早起一小时?(转)
2014-02-25 22:03 881早起是个不过时的话题 ... -
中医教你如何睡觉
2014-02-21 22:40 716中医教你如何睡觉人一个晚上不睡,一百天都补不回来。睡觉的诀 ... -
学会成长(转)
2014-01-04 23:49 898人不成熟的第一个特征:就是立即要回报 他不懂得只有春天播种 ... -
2012年回顾
2013-06-30 22:41 9632012年回顾 2012年过去了,回顾一下2012年主要做 ...
相关推荐
IT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdfIT项目管理最佳实践- .pdf
SCRUM实践 最佳实践文档 项目经理的首选
来自中培教育的【软件项目文档编写最佳实践】培训课程,仅供大家参考。版权归原组织所有。
通过遵循本文档的最佳实践,网络工程师可以提高项目交付的效率,同时简化网络运维,优化应用性能,使网络尽量运行在最佳状态。当然,不是所有的网络都是一致的,参考本文档指南修改网络配置之前,建议进行充分验证。...
根据最佳实践和简单的假设自动生成laravel项目的swagger文档
工程项目管理若干最佳实践.pptx
IT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docxIT项目管理最佳实践- .docx
所有最佳实践都辅之以实际的项目案例,并对案例代码进行了深入分析,实践性和可操作性极强。 《.NET最佳实践》可分为四个部分。第一部分(第1~5章)着重教授你如何选择和发现这些实践,如何提升团结度,如何量化...
某供电公司业务流程优化设计项目最佳实践差距分析详细报告.pptx
项目经理必备的各类文档,相当实用。包含了各类常用的图表模板。
所有最佳实践都辅之以实际的项目案例,并对案例代码进行了深入分析,实践性和可操作性极强。 全书可分为四个部分。第一部分(第1~5章)着重教授你如何选择和发现这些实践,如何提升团结度,如何量化这些实践等。第...
工程项目管理若干最佳实践教材.pptx
推荐,最强大数据学习与最佳实践资料合集,基础+架构+治理+案例,共100份。 一、基础篇 快手EB级HDFS挑战与实践 Hive任务开发规范 一文看懂Hadoop生态圈 资料-CentOS7搭建Hadoop-2.7.7集群 ClickHouse官方中文文档 ...
XX公司业务流程优化设计项目最佳实践评估主报告.pptx
随着开发项目的增多,我们不断总结经验,把这些最佳实践以文档的形式整理出来。 这份文档是我们集体经验的结晶。除了我们之外,相信其他公司、组织或开源项目也能从中 受益,现在时机成熟了,我们决定将其公开...
XX公司业务流程优化设计项目最佳实践评估报告.pptx