文档里的示例贴过去报错,用户第一反应是「这服务不行」。

我的做法:每个示例代码放进测试里跑一遍,CI 挂了就说明文档过期。

成本:写测试的时间。收益:用户信任。

另一个做法:提供能直接执行的 curl 命令,带真实可用的测试 key(限额度)。

用户第一次调用成功的时间,决定了会不会继续用。这个指标叫 time to first call,越短越好。

主楼