跳到内容
商家帮助中心
Esc
切换打开⌘J预览
本页内容

帮助中心改为两轴结构

从 17 个任务分区平铺改为「使用手册 + 功能详解」两条轴:前者回答怎么做,后者回答这个功能的边界与前提。API 文档同时拆成独立站点,商家侧搜索不再混入接口条目。

帮助中心此前是 17 个任务分区平铺,缺少「某个功能完整能做什么、边界在哪」这一层。这次把内容组织成两条轴,并把面向开发者的接口文档搬出商家侧。

具体变化

使用手册

「我要办一件事,跟着步骤做。」原有全部内容都在这条轴上,每一页回答一个「怎么做」,给出后台里的实际操作顺序。

功能详解

「这个功能完整能做什么、有哪些前提和限制。」这是新增的一层,首批覆盖五个功能:

此前这类问题(「在线选片到底能做什么、有什么限制」)只能从若干篇操作指南里自己拼,答案还可能互相矛盾。现在规则只写在这一层,操作页遇到规则一律链过来。

API 文档拆成独立站点

面向开发者的接口文档拆成独立站点 API 文档,地址由 /docs/developer-api/<页面> 变为 /docs/api/<页面>。两个后果对商家是直接可感的:

  • 商家侧侧栏不再混入「签名」「幂等」这类接口条目;
  • 站内搜索不再把接口 schema 和操作步骤混在一起返回——搜「订单」只会得到「怎么建订单」,不会同时给出 POST /orders 的字段表。

做系统对接的同事请把收藏改到新地址。

后续调整