Skip to content

HTML API migration leaves placeholder index pages with no useful content #738

Description

@Foesa-yyx

This was generated by AI during triage.

Related Migration PR

Problem

After the #723-#730 migration fixes, the latest PR #712 output still contains generated API reference index/group pages whose only body content is the placeholder sentence:

This section contains migrated API reference pages.

These pages render as empty or low-value API reference pages when users land on section/group nodes.

Evidence

Checked against latest origin/codex/cn-newdoc-html-api-migration at:

cdc9bb88e fix: deduplicate generated API anchors (#730)

A scan found 35 placeholder pages under content/docs/zh-CN/api-reference.

Representative examples:

  • content/docs/zh-CN/api-reference/flexible-classroom/android/api-reference/index.mdx
  • content/docs/zh-CN/api-reference/flexible-classroom/electron/api-reference/classes/index.mdx
  • content/docs/zh-CN/api-reference/flexible-classroom/web/api-reference/classes/index.mdx
  • content/docs/zh-CN/api-reference/rtc/android/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/cpp-all-platforms/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/csharp-windows/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/electron/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/flutter/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/harmonyos/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/ios/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/macos/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/react-native/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/unity/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/unreal-blueprint/(current)/index.mdx
  • content/docs/zh-CN/api-reference/rtc/unreal-cpp/(current)/index.mdx
  • content/docs/zh-CN/api-reference/whiteboard/web/classes/index.mdx

Scope Notes

This is related to, but not fully covered by, the earlier issues:

This issue tracks a distinct remaining output shape: generated index/group landing pages that contain only placeholder body text. These are not frontmatter-only files, so they can pass empty-body checks while still rendering as effectively empty pages.

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions