维护开源项目一年，最大的体会是：好文档比好代码更重要，一个文档烂的项目，代码再优秀也没人用。分享一下写好文档的心得。
一份合格的开源文档至少要包含：
最大的坑是文档跟代码不同步，发布前一定要检查。另外，文档要面向新手写，维护者自己太熟反而容易跳过关键步骤。
大家的开源项目文档是怎么组织的？有什么让文档更好维护的实践？
暂时没有回复。
Related
讨论
社区讨论帖，欢迎分享你的经验和观点。
讨论
每次以为开源快追上了，闭源一个新版本又把差距拉开。推理能力、长任务稳定性、agent 能力，开源暂时还是跟不上头部闭源。 不是说开源没用，自部署、隐私、成本这些场景开源还是香。但在"最强能力"这条线上，闭源目前确实领先。 希望开源继续发力追上。大家日常用开源多还是闭源多？觉得差距
讨论
做应用最纠结的就是选型，我把三种路线的取舍理一下。 闭源 API：能力最强、上手最快、最贵、数据要出域。开源 API（第三方托管）：能力次之、便宜、灵活。完全自部署：最便宜（量大时）、数据完全自控、运维和硬件成本高、能力打折。 我的经验是：早期用闭源快速验证，规模上来后核心链路切
讨论
为了隐私和零成本，我用 Ollama 在本机跑了几个开源模型，聊聊体验。 7B 左右的模型在我 16G 显存的机器上跑得还行，速度能接受；再大就吃力了，要么慢要么塞不下。日常做摘要、翻译、简单问答够用，复杂推理和长任务还是得靠云端大模型。 最大价值是离线、隐私、零成本原型验证。大