You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
After rerunning the latest HTML API migration stack locally, RTC DITA/Oxygen API reference navigation still exposes generated group/index pages that render as empty or near-empty API reference pages.
For example, in RTC C# Windows, the sidebar shows a group label 音频相关 and also a clickable page 音频相关. Opening the clickable page renders only the page title/frontmatter-derived content instead of actual API content.
This appears to be the same class of issue previously tracked in #738, where shczhen commented that regenerated API output contained zero placeholder pages.
A local scan found this frontmatter-only group index.mdx pattern across RTC Android, iOS, macOS, C++ all platforms, C# Windows, Electron, Unity, Flutter, React Native, HarmonyOS, Unreal C++, and Unreal Blueprint.
Impact
Users can navigate to API reference section pages that contain no meaningful API content. The sidebar also shows duplicated section concepts: one non-page group label and one clickable page with the same or near-identical title.
Scope
Confirmed locally across RTC DITA/Oxygen platforms after the latest migration rerun. The screenshot evidence is from RTC C# Windows, and the same generated file pattern exists across the broader RTC DITA/Oxygen lane.
Problem
After rerunning the latest HTML API migration stack locally, RTC DITA/Oxygen API reference navigation still exposes generated group/index pages that render as empty or near-empty API reference pages.
For example, in RTC C# Windows, the sidebar shows a group label
音频相关and also a clickable page音频相关. Opening the clickable page renders only the page title/frontmatter-derived content instead of actual API content.This appears to be the same class of issue previously tracked in #738, where
shczhencommented that regenerated API output contained zero placeholder pages.Evidence
Latest local rerun context:
shengwang-doc-sourced1ebc73e4d77451cb5858913618a9eb82ed31bdfdocs-portal/CN-NEWDOC22ddd35448164b6d052617721c9128d1ad0353339d2fe1e592ae6fdb0076651b018f609fdadf12c475e1808fe710a2c91831f97625833ad11454c539Local preview evidence:
http://127.0.0.1:3044/zh-CN/api-reference/rtc/csharp-windows/audiohttp://127.0.0.1:3044/zh-CN/api-reference/rtc/cpp-all-platforms/audiohttp://127.0.0.1:3044/zh-CN/api-reference/rtc/android/audiohttp://127.0.0.1:3044/zh-CN/api-reference/rtc/macos/audioRepresentative generated files with no MDX body after frontmatter:
content/docs/zh-CN/api-reference/rtc/csharp-windows/(current)/audio/index.mdxcontent/docs/zh-CN/api-reference/rtc/csharp-windows/(current)/video/index.mdxcontent/docs/zh-CN/api-reference/rtc/cpp-all-platforms/(current)/audio/index.mdxcontent/docs/zh-CN/api-reference/rtc/android/(current)/audio/index.mdxcontent/docs/zh-CN/api-reference/rtc/macos/(current)/audio/index.mdxcontent/docs/zh-CN/api-reference/rtc/ios/(current)/audio/index.mdxcontent/docs/zh-CN/api-reference/rtc/electron/(current)/audio/index.mdxA local scan found this frontmatter-only group
index.mdxpattern across RTC Android, iOS, macOS, C++ all platforms, C# Windows, Electron, Unity, Flutter, React Native, HarmonyOS, Unreal C++, and Unreal Blueprint.Impact
Users can navigate to API reference section pages that contain no meaningful API content. The sidebar also shows duplicated section concepts: one non-page group label and one clickable page with the same or near-identical title.
Scope
Confirmed locally across RTC DITA/Oxygen platforms after the latest migration rerun. The screenshot evidence is from RTC C# Windows, and the same generated file pattern exists across the broader RTC DITA/Oxygen lane.
Links
Parent: #690
Related PR: #704
Previous issue: #738
Previous fixed comment: #738 (comment)