当前位置:  技术问答>java相关

讲讲写注释和技术文档的重要性吧(内同,期待高见!)

    来源: 互联网  发布时间:2015-01-22

    本文导语:  | 当写软件的人走了后,老板要你接他的手,而他没有留下文档,你可以想象得到。 | 文档和注释也是代码的一部分。纯代码是给计算机看的,文档和注释是给人看的。计算机不会自动修改功能,...


|
当写软件的人走了后,老板要你接他的手,而他没有留下文档,你可以想象得到。

|
文档和注释也是代码的一部分。纯代码是给计算机看的,文档和注释是给人看的。计算机不会自动修改功能,如果要修改,只能人来修改。如果没有注释和文档,从何修改?

|
1)主要是一个项目大多十几个人做,而维护的只有几个人。
几个人要在短时间内看懂全部的程序。没有良好的注释根本看不懂。
2)就算自己做的程序,过了一段时间,若是程序量比较大,只怕自己都很难懂。
3)写技术文档也是技术成长的必然道路。自己可以对作项目中学到的东西作系统的整理。

|
我们这个行业人员流动率太高,所以不可能全都是一个人或一个开发组贯穿整个软件的生命周期。
当软件需要维护或做了一半让你来做时,没有这些你会浪费大量的时间及精力。所以为了别人也为了自己(难保过个三四年你会忘掉自己当初写的东东)我们都应该写注释与技术文档。

    
 
 

您可能感兴趣的文章:

 
本站(WWW.)旨在分享和传播互联网科技相关的资讯和技术,将尽最大努力为读者提供更好的信息聚合和浏览方式。
本站(WWW.)站内文章除注明原创外,均为转载、整理或搜集自网络。欢迎任何形式的转载,转载请注明出处。












  • 相关文章推荐
  • 我把JAVA和C++都搞混了,希望JAVA、C++爱好者给我讲讲里面的程序注释问题在JAVA和C++中都有哪些不同。
  • 一个菜鸟的请求: 哪位前辈能给晚辈讲讲“匿名类”
  • 请问如何改变以创建窗口的背景色,该用什么函数,能讲讲吗?
  • ★☆★可否讲讲cp命令是否和copy命令相同,如有不同,请指出!!谢了
  • 求解!给讲讲原理,谢谢谢!
  • linux 双网卡同时工作怎么做啊,请高手给讲讲哈
  • 谁给我讲讲回调函数的概念???
  • 请教哪位帮我讲讲JNDI
  • 帮我讲讲Apache,Tomcat,JServ的关系,多谢。
  • 哪位大侠能讲讲怎么将一个用EJB写的站点做成安装程序?
  • PrepareStatement的问题,哪位有空给我讲讲
  • 哪位好心人能给我讲讲?
  • ****菜鸟问题:谁能给我讲讲端口?***
  • 谁能跟我讲讲javabeans究竟是做什么的,为什么说它好
  • 谁能给我讲讲tomcat4.0.3的Listener怎么用?
  • 谁能给我讲讲“ulimit -m”命令使用来干什么的?
  • 请问谁能讲讲使用软件实现的mcu原理。
  • 那位能讲讲这个东西是怎么回事?
  • 哪位高手能详细的讲讲内核中slab allocator到底是什么?
  • 那位前辈能给讲讲oc4j阿?
  • 谁能讲讲网页发手机短信的原理?使用applet发送的吗?


  • 站内导航:


    特别声明:169IT网站部分信息来自互联网,如果侵犯您的权利,请及时告知,本站将立即删除!

    ©2012-2021,,E-mail:www_#163.com(请将#改为@)

    浙ICP备11055608号-3