为什么文档对 SaaS 至关重要：隐藏的投资回报率

文档是产品中唯一在人们都不值班时仍能发挥作用的部分。它在凌晨 3 点、搜索结果中、AI 助手里，以及评估过程的前十分钟内提供答案。本页面解释文档影响收入的机制，以及如何在自己的产品上进行衡量，而不是盲目相信行业平均值。

我们打造了 Docsbook。下面的每个数字都需要由你自行衡量——我们不会发布无法溯源的基准百分比。

糟糕的文档究竟会带来什么成本？#

糟糕的文档不会形成一项单独的成本。它会将成本转移到已有预算的三个团队：支持、工程师入职培训和销售。这就是为什么它在电子表格中不显眼，却在实际工作中代价高昂。

这三项转移，按大多数公司察觉到它们的顺序排列：

衡量交接次数，而不是文档本身。以下四项数据，你本周都可以收集：

前两项成本最低，也最有说服力。对工单添加标签并统计一个月，就能把“我们的文档还可以更好”变成一份带有具体数量的清单。

在大多数组织中，没有人负责文档。工程团队在截止期限的压力下编写文档，市场团队不把它视为一种渠道，而支持团队只能被动承担后果，却无力解决根本原因。页面有所改进时，没有人的季度目标会因此发生变化，所以也就没有人编辑页面。

第二个原因是，在进行衡量之前，这项工作是隐形的。支持工单量会被报告；但“本来可以由某个页面避免的工单”默认不会在任何地方被报告。

这些工具分为两大类，选错类别的代价，比在同一类别中选错产品更高。

类别	示例	你拥有的	你不拥有的
静态站点生成器	Docusaurus、VitePress、MkDocs Material、Starlight	主题和构建的完全控制权	托管、搜索、升级、AI 功能
托管平台	Docsbook、GitBook、Mintlify、ReadMe	内容	构建、托管、搜索、AI、分析

静态生成器的成本是工程时间，而无需订阅费。托管平台的成本是订阅费，而无需工程时间。当没有人负责内容时，两者都会以同样的方式失败。

Docsbook 将 GitHub 仓库中已有的 Markdown 发布为文档网站，并报告读者如何使用这些内容。这里说的是机制，而不是承诺：

真实来源仍保留在 Git 中。 文档与发生变更的代码在同一个拉取请求中编辑，因此页面过时会在评审时暴露，而不是等客户发现。
机器也能读取网站内容。 Docsbook 发布 llms.txt 并运行 MCP 服务器，因此当助手回答有关您产品的问题时，可以读取您的页面，而不是猜测。请参阅用于文档的 MCP 服务器。
助手根据您已建立索引的页面回答。 原本会提交工单的读者，可以直接在页面上得到答案，并且答案会使用他们提问时的措辞。
分析会将缺口报告为问题。 失败的搜索和未得到回答的助手问题会以待撰写内容清单的形式呈现，并保留读者自己的措辞。请参阅文档分析：需要跟踪什么。

用证据而非观点回答以下四个问题。每个问题都对应上表中的一项计数。

如果其中任何一个问题没有答案，那么需要改进的是衡量方式，而不是重新设计。

Docsbook 采用按需付费，而不是分级定价。每个项目都有自己的余额，该余额用于 AI 使用——网站本身、托管、阅读和搜索不会消耗余额。当前价格请查看 docsbook.io/pricing，该页面在每次请求时根据实时价格常量生成；博客文章中复制的价格可能会悄无声息地过时，因此请以该页面为准。

发布您现有的代码仓库，然后花一周时间查看失败的搜索。