好的文档 = 免费的增长飞轮。从框架选型到写作风格，系统化构建让用户爱不释手的技术文档
Stripe 凭什么成为开发者首选支付 API？不是因为技术最好——Braintree 也不错。是因为 Stripe 的文档体验碾压级别的领先。当开发者 Google "how to integrate payment"，Stripe 的文档永远排第一。这个自然搜索流量，按广告价值计算每年超过 $10M。文档不是成本中心——是增长中心。
Docusaurus vs Mintlify vs Nextra vs GitBook vs Notion——各适合什么场景、成本、部署方式
OpenAPI/Swagger 自动生成、Zod→JSON Schema、Try It Out 交互式文档、认证示例、错误码文档
5 分钟 Quick Start 法则、渐进式教程结构、可复制粘贴的代码块、从零到 Hero 的学习路径
Keep a Changelog 规范、Conventional Commits 自动生成、Release Tweet/Thread 模板、用户可订阅的更新
技术写作的 10 条规则、主动语态、短句、代码>文字、避免 jargon、中文技术写作的特殊注意点