不管是否学Java教程,只要是程序员,基本上都是不喜欢写文档的。而且不想写的原因高度相似,这是为什么呢?因为写文档真的很烦。
很多程序员都有一个观念,代码即一切,只要我代码写好了,其它问题都不是事。所以说文档什么的能免则免,不过,公司越是“正规”,文档种类就越多,种类越多,程序员就越是头疼的厉害。
而且即便是写,也不见得一定能写好,尤其是项目繁琐的时候,还需要花费大量时间去写。而且你即使是费时费力写的文档,只要客户那边需求一变,可能所有文档都要进行更新,严重的可以说前功尽弃。
一旦你写的好,你能得到的并不是夸奖和表扬,而是无休止的问题。大家都会问你各种关于文档的细节,这样要怎么写,那个要怎么写。而平时本来就已经够忙了,白天各种琐碎事情占据了不少时间,晚上还要写文档,写代码,简直累到崩溃。
当然,人都是双标的,或许你自己并不想要写文档,但希望别人一定要写,这样对你来说方便很多。尤其是去到一个新的项目组时,你会非常期待对方有写文档,那样你也可以快速融入其中。
至于Java教程的时候要不要养成写文档的习惯,只能说见仁见智吧。因为写文档和正常工作之间真的非常难以平衡,如果需求固定,或者说时间宽裕,那相信会有更多程序员愿意去写文档的。
本文原创 文章来源:好学谷 转载请标明出处:http://www.haoxuegu.com/