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

[Vaspike]

• 矛盾

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

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

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

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

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

[aikilan]

你的领导是对的

[Akiya]

文档要多详细暂且不说，稍微工作过几年都应该知道需求确定的过程比实际开发难多了，尤其现在 AI 这么强，你把需求写完以后基本上代码逻辑都不怎么需要自己动手了

[roykingH]

编码本身就是耗时低级的工作 设计才是软件的核心 设计文档写的好 工程师可以直接把编码的工作丢给应届生或者 ai 完成

[4ark]

你觉得你应该庆幸你在这样的团队里面

[wanniwa]

按你说的，文档设计完了，基本上伪代码都写完了，照着思路改成代码很快的。

[dif]

工资待遇很不错，干啥都行。开会时间多，怕是没有主题吧。一开会就发散。东拉西扯得问题都要在会上解决。

[liyafe1997]

这算好了，如果你去搞汽车电子，很多情况下文档/流程这些乱七八糟的东西甚至占到工作量的 80%，甚至专门有一个团队去做这些，人比开发团队多。

[lshbosheth]

给时间 就行 这种是很正确的流程啊 0.0 正常就应该开会时间大于开发时间 开会就把如何实现与波及分析都做了 写代码不就是按部就班嘛

[orioleq]

需求以业务为主导的软件开发流程确实是这样，如果需求分析和系统设计做得清晰，后面开发和测试都省力。这一点会跟以技术为主导的快速 demo 的项目完全不一样。
如果是业务主导的开发 leader ，特别是只写思路代码交给小弟填充的，写设计文档这个能力是必须的吧。不然等代码都好了，再 review 再不断做 refactor ，又要搞好几轮，到时候挫败感更强。

[Leeeeex]

@Tyrant1984 这种就适合 ChatGPT 润色

[iyaozhen]

核心矛盾: 工资待遇很不错
啥意思？工资给的高呗 那你还说啥

[开会的时间占到了工作时间的 50%左右] 正常，当然具体要看会的内容
"写代码为低级工作,确定业务为高级工作" 可以说很对了，没毛病

矛盾这个我说个事情，之前有个很大的 leader 说，如果我推行一个决策，都需要和每个人解释清楚，那事情就做不了了。所以很简单，如果你工作没几年就跟着 leader 走。如果你本身已经有一套方法论了，和 leader 不合拍那就换个团队。

[yKXSkKoR8I1RcxaS]

只要不加班，那就是好的，只要加班，就算是再好的也是垃圾。

[yueyuea]

挺好的，我认为 coding 占用我们的工作时间应该不超过百分之 20 ，剩余时间都应该在反复的思考和沟通（当然还有摸鱼）。有效的沟通加文档可以减少很多无意义 coding 时间，比所谓的靠加班来完成工作的 leader 强的不是一星半点。

[weilongs]

同感,但我这个领导不是纯写代码,是一个网络方面的出身,写过代码. 他的想法就是写代码基本上有手+baidu 就行了. 也是让我写文档灰常细致,以及他要学习怎么启动、调试. 我觉得他这想法就是一直做我的备份.是在备份不了也要找一个好接手.

[ArrayBuffer]

认同领导的做法, 我觉得核心的问题是文档是否物尽其用, 文档的可读性好不好, 维护工作是否能做好, 能让别人看懂的文档才是有价值的

[hitmanx]

这个其实问题不大。是应该多花时间在设计上，设计阶段应该把所有的需求和未来的扩展性都考虑到，然后进行 review 。等到一切通过了，照着实现应该是很容易的。甚至设计和实现的可以不是同一个人。

如果设计没有具体到另外一个人上手就能写代码的程度，说明设计还是不够具体。我工作过的几家外企，设计都是到这个程度的。

但是国内的企业一半都是工期紧、任务重，很多东西都是没设计明白就键盘梭哈写代码了，回头再东改西改，这个其实是个坏的习惯。

[keakon]

你们没经历过重构么？
文档是不是也得重构啊？

[ZZITE]

@keakon #56 有啥问题，你都把代码重构了，文档不重写吗？这不就是坑对接的人

[horizon]

@Mithril #4
你这明显违背了初衷
要先写文档再写代码，而不是反过来

[keakon]

@ZZITE 什么项目对接要看文档里的私有方法？你代码里用 IDE 几秒钟就重构完了，然后点开几百篇文档去替换字符串么？