程序员在上班时,允不允许大量的看说明文档来帮助写程序?

Celiaki


小七,前端工程师,关注我一起学代码,每天都有干货。

这个问题怎么说呢,开发过程中会遇到各种各样的问题,没有一个人是全能的,也没有人可以绝对的说自己在整个项目中不会遇到一点问题,不去查东西,自己大脑里的东西完全可以让我把这个项目测测底底的做完,并且没有任何bug。

上班的时间,也没有老板或者谁在后面一直看着你去做东西,大家都挺忙。文档是干嘛的,文档本身就是用来看的,甚至很多项目开始之前,总监都会让你去搜集一些这个项目可能会遇到的bug,可能会用到的效果,尽量在之前找到比较好用的插件,这样会节省很多时间,自己如果写代码的话不可能百分百的确定没有人和bug,但插件不一样很多插件都是前辈通过很长时间慢慢完善出来的插件,所以很多人才会用。所以你提问的可以肯定的回答你允许。


哎吆喂网络前端


先开个玩笑,提此问题的兄弟或许是软件公司主管,或者是一家小软件公司的老板,或者是刚被领导剋了的程序员,不知猜对了否?呵呵

首先给个结论,上班时间花大把的时间看编程说明文档不可取,尤其是那些拿着高薪的资深程序员。




现在各行各业都不容易,对软件企业而言,时间就是金钱,效率就是生命,更是如此。公司请你来是干活的,要以比竞争对手更快的速度做出更好的产品,而不能把宝贵的上班时间浪费在看编程说明书上。

实际工作中程序员或多或少会在工作时间看说明,工作不是很紧张或时间不长或者是新手问题都不大,难免。但是时间长了领导和老板会留意的,有时他们不一定直接说出来,但心目中会对你留下一个不好的映像,转正加薪提升可能在不知不觉中受到影响。

但是,对于新的语言或开发技术,的确需要看看SDK手册或程序范例,怎么办?建议大家自己辛苦下,下班周末等业余时间利用起来,或者下班后有意识的加加班,这时看说明就没什么问题了。

还有就是尽量边干边学,在战斗中快速成长,不必让人家看到专门拿时间去正经八百地看说明。

作为程序员,快速学习、快速上手是必备的基本功,练就此功后就没必要在上班时间专门看说明了。

也许我上面的回答让有些年轻的朋友
觉得是不是太小气,搞得连学习时间都不给。没办法,现实就是这样,想在公司快速冒尖,只能对自己狠一点,快速成长起来后你回发现,你的一切努力绝对是值得的。

2018.3.5夜于武昌


软件之道


首先,我不是程序员,我是一个设计工作者,不过我来说一下我的观点:很多人以为程序员像电影里的一样,啪啪啪几下键盘,屏幕数据飕飕的变,其实真实情况是程序员写代码就像学生写作文,也会遇到不会的词语跟修辞手法,那这个时候就要停下来想一想,查一查,看看例子是怎样写的怎样用的,写错了还要划掉(删掉)再来,至于这个大量不大量看的情况,如果这个是个新手,那肯定是可以的,那如果是个老手,还需要大量时间查说明文档,那就说明这个项目肯定不会小,不是一两天能做完的,那一个用月做单位的项目,用一个天做单位的时间来查文档,不过分吧!程序员也是人,不是因为他的工作高端,就觉得这个人万能,他也会当机,要吃饭,要休息,也会忘记一些东西,所以请各位多多体谅,能一起工作实属不易,感恩2018,谢谢。


好人王小明


当然允许看文档。


要知道,随便哪个类库,都有无数的类和方法,每个方法又有若干参数,鬼知道它们都是什么意思,谁的脑子能记得那么多内容。别说是人家提供的类库,就是自己写的代码,过一段时间也不记得什么意思了。没有注释和文档,怎么看懂代码?


如果没有需求分析文档,程序员怎么理解正在开发的这个软件的基本业务流程?

如果没有架构设计文档,程序员怎么理解软件各个功能模块之间的功能与业务逻辑?

如果没有接口文档,那么多类和方法,都怎么调用,会返回什么值,难道靠猜?

……


在日常开发工作中,不仅允许看文档,还会强迫你写文档。如果你写的文档别人看不懂,别怪领导骂你不认真。文档对于软件开发的重要性是不言而喻的。


还有一个秘密告诉你,那些经常写文档的程序员,要比不写文档的程序员工资更高。

真的!!!


迎娶白富美,从会写文档开始!


学习考试系统


程序员日常开发工作,基本是上离不开阅读文档,这也是很多程序员喜欢两个显示器的原因。


项目方面

  • 架构文档:这个是进入一个新项目之后,最快了解项目的方法,也是从宏观了解项目的最佳途径。

  • 设计文档:其实设计文档很多项目都是缺少的,我的建议是设计文档可以不用写的很正式,但设计的思路最好可以存留。

  • 需求文档:没有需求文档,没办法开发吧。开发的过程中,也要不断地、反复的阅读需求文档,甚至有可能在开发的时候发现需求不合理的地方。


技术方面

是不是很多人都认为,如果在开发过程中,还要不断地翻技术文档,说明他的开发能力不扎实。其实不是这样的。

首先IT行业技术升级换代的速度太快,当我们大多数公司还在用Java8的时候,Java11都已经出来了。如果非得要程序员熟知每一个类、每一个方法,是很不现实的。

很多时候我们只需要了解有这么一个东西,作用是干什么的,具体的细节可以在用的时候再去翻文档,比如方法名字是什么?参数有几个,都是什么类型的?


所以我们都习惯至少两个电脑屏幕,一个屏幕写代码,一个屏幕看文档;如果豪一些的话,再加一个屏幕展示日志信息。

看文档的屏幕要买竖屏!


我们团队

我这几年也带过几个团队,对于每个团队成员,我对他们的要求是:实现需求的前提下,最好能对所用的技术有一定的了解,千万不要从网上抄过来一段代码就用,这样是很危险的行为。所以鼓励大家多找一些资料,最好是阅读框架的官方文档。

现在的团队,我已经这样要求了:代码写累了,或者觉得自己没有状态写代码,可以找点儿自己有兴趣的技术文档学习学习,这个技术甚至是可以跟现在的项目没有关系的。


会点代码的大叔


兄dei,假设你是程序员,你在写程序时,旁边会有人守着你吗?

假设你不是程序员,你在做本职工作时,旁边会有人守着你看你怎么做事吗?

答案肯定是没有的。谁会闲着招个人去监督你,看你用什么方式去完成给你的任务。

现在不管是大公司还是小公司,没有人会在意你怎么去完成你的工作,给你的任务,在很多时候,大家只关注结果。如果说有干预,最多只是实现的方式。像写程序,假设有个功能是即时通讯相关的,这种自己写需要的时间成本投入较高,那么很多公司就会选择采用市面上比较稳定的第三方平台。这算一种实现方式的干预。但是在接入的过程中,不会有人去管你是通过阅读第三方SDK文档,还是谷歌搜出来的,最后能达到预期效果就ok了

所以,其实你看不看大量文档,没有人会在乎,关键是你自己,建议自己写东西时,不要一味的复制粘贴,要有自己的想法。太依赖文档对于自己成长很不利




安之5


本人作为一个技术管理人员,分享下我的看法,首先你这个问题有点不对,也少了前题条件。看说明文档基本都是允许的!我觉得问题侧重点应是:应不应该。

对于新技术或攻关类项目,大量阅读文档是家常便饭,同样对于新人来说,这也无可厚非。对于管理人员,在意的是学习能力、团队沟通能力、独立解决问题能力,所以对于有经验的开发人员,能看文档能解决问题的,还是能接受的,但是经常性看了文档都解决不了问题就另当别论,另外,假如同样的知识点,使用很久仍没消化,严重依赖文档的,那就是学习能力或态度问题,值得反思,多少会影响管理层对你的评分。


IT晴天看世界


程序员上班的主要工作就是看说明文档,根据说明文档编码。如果实在没有说明文档,有时还得亲自披挂上阵写说明文档。

写接口的有API文档,写通讯协议的有协议字段说明文档,写数据库的有数据库规范文档,

总之任何一个大公司文档扮演的一个至关重要的问题,因为形不成文档,公司管理就会陷入混乱不堪的局面,当某个核心员工离职后,下一个接盘的程序员会丈二和尚摸不着头脑,一头雾水,边填坑边骂娘,有了文档就可以看文档结合代码,了解其中模块逻辑以及结构,包括哪些坑不能踩等等好处。有些公司会专门有文档工程师这个职位来专门负责整理各种文档,并且保存在服务器上。

好的文档都是程序员等人智慧的结晶,是一盏指路明灯,是一条通往光明的道路。程序员不能看说明文档等于在黑暗里摸爬滚打,有了说明文档才迎来了黎明的曙光。


电视鹏


这个问题要根据具体开发的功能模块来看,不过原则来说,花大量的时间看说明文档,至少给人的印象是经验不够丰富,开发能力有待提高。

具体来说,如果是普通的功能开发,技术挑战不大,这种如果还要看文档,会被认为是开发能力问题。如果是有一定的技术挑战,公司在这方面的积累比较少,开发团队也对此有共识,这种问题看文档无可厚非,当然如果能业余时间学习相关的知识,会给团队留下开发能力强的印象。对于一些前瞻性研究,公司没有任何技术积累,或者全新的技术方向,这个看说明文档是加分的,甚至可以要求公司购买相关书籍或者在线培训,当然,自己啃下来会更NB。


丽莎公主的爸比


题主对文档的定义不是很明确

第一个是需求说明文档

这个是在开发过程中必不可少的文档,只有清楚了开发需求,程序员高效率的开发,程序员一天的工作时间并不是都是在写代码,而是在看文档,了解需求,理清思路,只有什么都清楚了,写代码或许只要十几分钟。

再者对于一个项目新人来说不看文档了解需求,没人给你从头到尾的在讲一遍需求,你不看文档自己发挥?进入项目是和别人共同开发,你不肯能不顾及之前的代码规范。

第二个是开发文档

就拿微信开发来说,微信开发不是每个程序员必须会的东西,但是用到了怎么办,还不是去看他们的开发文档,只有将开发文档思路理清楚了,才可以进行下一步开发。

第三个是API文档

在前后端分离的开发模式中API文档是必不可少的文档。不看API不知道数据是什么样。也就是不可能顺利的和后端进行结合。


分享到:


相關文章: