Problem
The migrated Local Server Recording C++ and Java API reference sidebars do not preserve the legacy API Reference document structure. Legacy API Reference presents the recording APIs as separate grouped documents, while the migrated Fumadocs sidebar exposes generated Doxygen class/struct/interface pages directly, such as io.agora.recording.RecordingSDK类 参考 and individual C++ class/struct pages.
Evidence
- Local candidate preview:
http://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/java/classio-1-1agora-1-1recording-1-1-recording-s-d-k shows a Java class page as a sidebar entry.
- Local generated Java meta:
content/docs/zh-CN/api-reference/local-server-recording/java/meta.json lists class pages directly, including classio-1-1agora-1-1recording-1-1-recording-s-d-k, interfaceio-1-1agora-1-1recording-1-1-recording-event-handler, and many generated enum/class pages.
- Local generated C++ meta:
content/docs/zh-CN/api-reference/local-server-recording/cpp/meta.json lists Doxygen class/struct/file pages directly, including classagora-1-1recording-1-1-i-recording-engine, classagora-1-1recording-1-1-i-recording-engine-event-handler, and generated namespace/struct/file pages.
- Legacy source Java menu:
shengwang-doc-source/html-docs/recording/Java/menudata.js keeps Doxygen's grouped API navigation (首页, 相关页面, 类, 类列表, 类索引, 类成员).
- Legacy source C++ menu:
shengwang-doc-source/html-docs/recording/cpp/menudata.js keeps grouped API navigation (首页, 类, 类列表, 类索引, 类成员, 文件).
- Review screenshot shows the expected user-facing Local Server Recording API Reference grouping with
API 参考 and Legacy API 参考, instead of a flat list of generated class pages.
Impact
Users entering Local Server Recording C++ or Java API Reference from the sidebar see implementation-level generated Doxygen pages as the primary navigation. This makes the migrated API Reference harder to scan and does not match the legacy entry structure used by the source documentation.
Scope
Links
- Java candidate:
http://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/java/classio-1-1agora-1-1recording-1-1-recording-s-d-k
- C++ candidate:
http://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/cpp/classagora-1-1recording-1-1-i-recording-engine
- Java source:
shengwang-doc-source/html-docs/recording/Java/menudata.js
- C++ source:
shengwang-doc-source/html-docs/recording/cpp/menudata.js
Problem
The migrated Local Server Recording C++ and Java API reference sidebars do not preserve the legacy API Reference document structure. Legacy API Reference presents the recording APIs as separate grouped documents, while the migrated Fumadocs sidebar exposes generated Doxygen class/struct/interface pages directly, such as
io.agora.recording.RecordingSDK类 参考and individual C++ class/struct pages.Evidence
http://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/java/classio-1-1agora-1-1recording-1-1-recording-s-d-kshows a Java class page as a sidebar entry.content/docs/zh-CN/api-reference/local-server-recording/java/meta.jsonlists class pages directly, includingclassio-1-1agora-1-1recording-1-1-recording-s-d-k,interfaceio-1-1agora-1-1recording-1-1-recording-event-handler, and many generated enum/class pages.content/docs/zh-CN/api-reference/local-server-recording/cpp/meta.jsonlists Doxygen class/struct/file pages directly, includingclassagora-1-1recording-1-1-i-recording-engine,classagora-1-1recording-1-1-i-recording-engine-event-handler, and generated namespace/struct/file pages.shengwang-doc-source/html-docs/recording/Java/menudata.jskeeps Doxygen's grouped API navigation (首页,相关页面,类,类列表,类索引,类成员).shengwang-doc-source/html-docs/recording/cpp/menudata.jskeeps grouped API navigation (首页,类,类列表,类索引,类成员,文件).API 参考andLegacy API 参考, instead of a flat list of generated class pages.Impact
Users entering Local Server Recording C++ or Java API Reference from the sidebar see implementation-level generated Doxygen pages as the primary navigation. This makes the migrated API Reference harder to scan and does not match the legacy entry structure used by the source documentation.
Scope
local-server-recording/cpp,local-server-recording/javacodex/html-api-latest-review-20260715Links
http://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/java/classio-1-1agora-1-1recording-1-1-recording-s-d-khttp://127.0.0.1:3044/zh-CN/api-reference/local-server-recording/cpp/classagora-1-1recording-1-1-i-recording-engineshengwang-doc-source/html-docs/recording/Java/menudata.jsshengwang-doc-source/html-docs/recording/cpp/menudata.js