说的没错 写了也没人看的 新来的基本不会去看

写文档最大的问题，其实是你还要维护，代码更新了文档就得更新，要不然别人看了反而会疑惑，但是又不能保证所有人改了代码都主动去更新文档

钱没到位

写好了没人看维护累😭 写差了被人挂贼生气🐶

不清楚别的语言怎么用的 我是写 PHP 的 目前用的 Laravel API 文档接口用的组件包 scramble 来生成文档 写每个功能都在代码里面写好注释 接口返回 模型资源都写好注释就可以了 然后完美符合 代码既文档 不用费劲去 Apifox 录入每一个接口和返回值了，改动以后都是立即生效的，能直观的看到每个接口的中文注释 返回字段说明

因为工时精确到 0.5 小时，没建工时那就不写

作为写过好几吨注释和交接文档的老倒霉蛋，我的经验是： 要么懒着文档直接问你咋回事，要么懒着看文档直接开干。所以项目整体写个大概介绍，一些特殊业务逻辑，神秘优化技巧啥的特殊写点注释，够了，不要浪费时间 哦对现在有 AI 了，更不用写了，跟你的 AI 去说吧

写文档也得分为什么写。把写文档列进绩效你就不吱声了。

写好注释就完事了呗

现在让 AI 写代码，同时也写文档，我自己懒得写