[吐槽贴]领导对于要求文档的详细程度到了偏执的程度

237 天前
 Vaspike

核心矛盾: 工资待遇很不错

写代码前要求我先把文档写出来,详实程度要求每个 service 中将会有哪些方法,共有私有

开会的时间占到了工作时间的 50%左右

领导是写代码出身,但每次开会和其他交流中都透露出对"写代码为低级工作,确定业务为高级工作"的看法

我不否认他的某些想法,目前也会尽力完成他想要的东西,只是怕很多矛盾后面会越来越尖锐 最近和其他同事一起下班才知道部门其他同事也对他颇有微词,我进来时替换的这个岗位原来的开发就是被骂跑的

8497 次点击
所在节点    职场话题
79 条回复
yuankui
237 天前
现在 AI 这么多,根据代码生成文档不难吧?
BraveChi
237 天前
1 、写文档要比写代码高级
2 、领导在锻炼你
3 、你干十年就知道了,去 tm 的写代码,还是写文档爽,谁干谁知道。文档可控,但是代码质量不可控啊。
konakona
237 天前
不清楚你的领导是否被讲不清内容的功能代码弄烦了,但是向上管理和自我驱动应是每一位优秀的开发者的职业素养才对。

最好的办法是跟你的领导多次碰一碰,输出“技术文档的交付物”为何,以及如何进行质量评估来不断提升活文档的能力 —— 这对你、对你的领导,都是很好的做法和发展方向。

你领导的性格可能就是这样的,要么接受他一起勾着,要么另谋高俅换组换领导。
doommm
237 天前
设计、接口文档可以写,私有的内部变量、方法这种涉及到实现细节的怎么事先写?设计的时候不能确定实现细节吧
akira
236 天前
需求都没掰扯清楚就让你开工干活,然后交付的时候 各种返工,

你不会想要这种的。。。
lzeeee
236 天前
总比上线之前改 prd 更舒服吧,你懂的
EndlessMemory
236 天前
要么加入,要么不加入
xFrye
236 天前
挺好的,团队如果一直都坚持这样维护文档,以后要是某个人走了去改他的代码你也会轻松点
woodfizky
236 天前
你这是身在福中不知福啊。。你领导说的没毛病啊。。


我领导的需求常常是,一两句模糊的话,没有文档。需要产品经理和开发自己去琢磨提炼原始需求。

时常出现领导太慢,需求太模糊,然后产品经理或者开发自己理解错误,准备验收的时候发现理解错误,返工还好,就怕颠覆原始设计。
woodfizky
236 天前
@woodfizky 69
typo: 领导太忙*
C3WC
236 天前
op 标题是不是有错别字?
xz410236056
236 天前
GPT 不就是做这些工作的???你把你想到的简单跟 GPT 写一下,让他帮你出个详设文档,你再稍微改一下,节约大量时间
abelmakihara
236 天前
这是日企还是做对日出来的吧
理想是好的但实际上...
hafuhafu
236 天前
时间给够就行,而且这反而很好生成对应的文字啊...
nenseso
236 天前
我感觉对于我这种边写边想的人很苦恼,我是属于前期大致画一下思维导图流程图,然后开始写,后面发现更好的设计会把前面推了重做,如果要我一开始写好文档开始搞,后面重新又要写文档
chevalier
236 天前
"写代码为低级工作,确定业务为高级工作"

我工作十年了,现在觉得你领导这句话是对的。公司是业务驱动的,写代码是最基础的事情。
xiangbohua
236 天前
"写代码为低级工作,确定业务为高级工作"
这句话很对,你领导应该是经历过的人。而且这样很好,有利于习惯养成,如果野惯了以后想提高就很难了,如果领导时间评估合理,并且会给予指导的话,那这领导妥妥的跟着啊。
xiangbohua
236 天前
@locoz 非常认同,我觉得不说单纯的 CRUD 了,即使是复杂的功能,如果不是自己设计的那么本身就确实比较初级。会写代码的人太多了,如果能快速准确的理解业务、然后根据经验快速给出扩展性良好、可行性高的方案的人就比较吃香了。
repus911
235 天前
只要把写文档加入排期和时间规划,我是赞成写好点和有标准,并随版本维护的,只是我给下面发任务会这么干

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1044990

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX