# Reference Bridge

[English](./reference_bridge.md) | [docs](./index.zh.md)

`docs/` 主路径到这里结束。接下来读者通常会进入两类需求之一：

- 想看更细的 API 细节
- 想了解更大的项目背景与外围资料

这些需求都合理，但它们与 onboarding 不是同一种阅读目标。所以它们应该放在第一次阅读路径之外。

## 接下来去哪里

| 需求 | 下一步阅读 | 原因 |
|---|---|---|
| 查看完整 API 面 | `docs_old/api.md` | 构造参数、工具函数、loader 元数据、底层行为等细节都在这里 |
| 版本升级 | `docs/migration.md` | 迁移很重要，但不应该挤进核心教学路径 |
| 查看发布历史 | `docs/changelog.md` | 更适合已经理解概念之后再看 |
| 理解项目动机 | `docs/why.md` | 解释这个库为什么存在、背后的权衡是什么 |
| UI / SDK 集成 | `docs/connect_to_ui.md` | 更偏 OpenAPI 与客户端集成问题 |

## 一个推荐的二次阅读顺序

如果你已经读完主路径，下面这个顺序通常最有效：

1. API reference
2. migration guide
3. GraphQL framework 细节
4. 项目动机
5. UI 集成说明

## 更多主题

除了上面列出的参考资料之外，随着使用深度的增加，以下主题也可能会有帮助：

- 继承与复用模式
- 各种框架的集成指南
- API 参考的进一步整理