文档支零破碎代码几乎没有注释是大厂常态吗

新加入某大厂某产品组。
1）设计文档基本没有，只能从历史讲座/汇报中找到一些slides拼凑起了大概程序框架。问老人说是infra这块已经很久没怎么大改过了，业务逻辑啥的都是N年前定稿，偶尔有些修补，现在组里面也基本都不熟悉了。
2）读代码发现只在重要的接口函数/基类里面有一些注释，派生类中具体的函数实现几乎没有注释（最近1-2年的代码），一看check-in都是小年轻（没有歧视的意思），感觉没有好好受过代码规范的培训/指导，或者是赶工赶时间导致没有注释（if——else 扎堆嵌套什么的都不算事）。
3）自己身上找原因，有可能是自己业务不熟，不太了解context所以看代码理解业务逻辑有点费劲。
因为只在一家大厂待过，不知道这是不是通病。

理念：不鼓励写注释，代码要清晰明确，代码本身就是注释。

执行：我们这儿代码不需要注释！

认真讲 如果楼主研读过clean code这本书，书里是不建议加注释的。代码本身从变量名到各种命名，都应该是self explanary。每一个method just does one thing。

我最恨两种码农，一种是代码不加注释的，另一种是非让我加注释的。

林子大了 什么鸟都有。大厂未必就都规范。😄

是的，因为原始文档只有最初的设计，后续小改都不会有完整的文档，绝大多数公司不存在有人当雷锋给你定期更新设计架构的文档。

大小厂在这点上基本都是一样的。大部分程序员天生不爱写文档，想要文档好，得招专职的写文档的岗位。

我们又不是烦跟别人align的xfn，那种有什么好烦的

补充内容 (2022-08-15 13:15 +08:00):
这是个bug？我是回复另外一个帖子的….请大家忽略我

大厂代码确实不怎么加注释，因为本身规范就要求你的函数变量便于理解，你看函数名和变量名就知道要干嘛，注释一般在比较复杂或者特殊的逻辑

柯基101 发表于 2022-08-14 21:16:40
大厂代码确实不怎么加注释，因为本身规范就要求你的函数变量便于理解，你看函数名和变量名就知道要干嘛，注释一般在比较复杂或者特殊的逻辑

就是看完函数命名依旧不清楚是要干什么的，尤其是什么generate，create，controller，factory套着娃出现