文档版本

本站把已发布接口和正在开发的能力分开维护。页面右上角的版本选择器会切换整套文档,不只是替换版本号。

版本状态适用场景
v0.1.0稳定版、默认版本已发布集成、生产兼容性和升级前对照
next开发版试用未发布能力、参与开发和评审下一版本

next 中的能力只有通过代码、测试、文档、Playground 和兼容性检查后,才会进入新的稳定版本。开发版文档不会自动成为发布承诺。

版本清单由仓库中的 apps/docs/versions.json 统一维护。构建会检查每个版本目录、首页和导航元数据,缺失时直接失败。

链接规则

  • 默认稳定版使用根路径,例如 /guide/
  • 开发版保留版本前缀,例如 /next/guide/fields
  • 对外分享生产集成文档时,优先使用稳定版链接。
  • 评审未发布功能时,链接中应明确保留 /next/