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

[Vaspike]

• 矛盾

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

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

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

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

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

[zhwq]

就当锻炼自己的文档能力了，后续对你帮助很大的。

[chaoschick]

没有什么是不能习惯的

[Meteora626]

写代码为低级工作,确定业务为高级工作 这句话没毛病，但是只要确定输入输出有啥就行了，写内部细节也太离谱了

[Mithril]

他的看法在大部分公司都是对的，毕竟造火箭的公司不多，CURD 能不能卖钱还是要靠业务。

要是我的话，就想想怎么从代码提取出文档。

要么自己改个 parser ，扫一遍代码列出所有 service 和方法，按照固定格式输出，然后自己添点东西改成文档。

要么找个开源的 LLM ，看看能不能改造集成让它给我生成文档。一般来说这种固定格式的文档，你自己写个服务调个开源的 LLM ，调一下模型或者搞提示词应该能很好的解决。
甚至你也可以反过来用文档生成代码。

都搞定了就可以准备跳槽了。这次再跳至少不会说什么 “公司技术栈陈旧，没有学习机会” 了。

[locoz]

有一说一，没太大问题...写业务代码就是低级工作，根据业务进行设计才是高级工作，只会写业务代码屁用没有。
先写文档还是先写代码就是个风格、习惯的问题，各有优劣。但是在当下，先写一份设计清晰、描述详细的文档，是可以让 AI 快速解决代码的问题的，只要你的文档足够明确，AI 生成的代码跟你直接写的没区别，甚至可能更好，而且在整理思路上还会更优于边写代码边改。

[beimenjun]

简明版：按照你的领导说的做

---------------------

本来就是要做设计的，你如果设计的比较清晰，甚至到处文档这部分工作你甚至可以直接让 AI 辅助。

如果“确定业务”意思是“搞清楚需求”，那我觉得优先级要比单纯“写代码”是应该排前面一些。

至于开会 50% 也很正常，如果系统牵扯的人和部门比较多，就是要开会确认的，这些都是得开会确认的。你设计提交上去，估计也是要开会说明，pass 了才可能让你正式写，等到结束了还有回顾时间，50% 很夸张吗，其实还好。

整体来说，按照你这个描述，我觉得你如果想吐槽，可能只是不适应。建议好好适应。

[TWorldIsNButThis]

日企出身？

[LawlietZ]

和你有类似经历，之前老板也是对文档要求很高，语句通不通顺都有要求，画图要求都很高，一个文档能改十几遍，确实难受，但确实也有提升，这种情况确实会导致下面员工离职率不低，只能说好好沟通面向老板输出吧，保证写文档时间够和薪资不错就行了

[wu00]

“写代码前要求我先把文档写出来,详实程度要求每个 service 中将会有哪些方法,共有私有”只有少部分优秀的开发有这个能力

[haliluya]

经历过这么多年，很赞同“写代码为低级工作,确定业务为高级工作”这句话。代码实现，随便找个两三年工作经验的，基本上都可以胜任（普通功能需求，无高深逻辑算法，不犟）。但是如果找一个对业务很熟悉，一聊就明白的，很难，码农在一个公司长久的优势基本上就是业务理解了吧...个人偏见，不喜随便喷

[smdbh]

给时间照做就行了
开始阶段，我觉得写文档和写代码都是一种设计结构的方法，写出来才能发现问题，逐步修改。这是管理者只愿意看图流程图之类的文档而已，没心思看代码。 除非是成熟项目，不然一次成型的概率太低了，最后还不是都要改

[watzds]

@Mithril #4 以前数据库语句都要给 DBA 审核，我就是这样先写代码，再自动提取哈哈，文档写这些东西繁琐了

[heyjei]

"写代码为低级工作,确定业务为高级工作" 这句话没毛病。 业务代码最不值钱了，其包含的业务知识才值钱。

[Mithril]

@watzds 对的，所以其实工作是死的，但人是活的。

自己在工作中研究点能提升自己工作效率的东西，工作就不会天天和上坟一样。只要工作能按时完成，大多数公司也不会阻止你做这些东西。

反正工作就是那些，自己找点乐趣好了。

[darkengine]

这个是很自然的流程啊，只不过有些步骤之前是在脑子里过一遍，现在是要你写下来而已。

[cmsyh29]

你领导说的没错

[nomytwins]

往往写代码的不这么认为"写代码为低级工作,确定业务为高级工作"。尤其是后端。

[murmur]

哦，这不就是日式开发吗

有幸看过某大型企业招标的代码要求，注释覆盖率 100%

怎么说呢

const six = 6 //66666666

[guanzhangzhang]

找一些框架按照代码生成文档，还能根据代码 tag 做版本管理😏

[azarasi]

可以用 doxygen 生成 xml 格式的文档，然后自己写一个程序解析生成领导要求的格式