Skip to content

Fix fumadocs-mdx validation: flatten nested pages in concepts meta.json#210

Merged
hotlong merged 2 commits intomainfrom
copilot/update-specification-references
Jan 26, 2026
Merged

Fix fumadocs-mdx validation: flatten nested pages in concepts meta.json#210
hotlong merged 2 commits intomainfrom
copilot/update-specification-references

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 26, 2026

CI build failing on meta.json validation - fumadocs-mdx expects flat string arrays in pages, not nested objects.

Changes

  • Flattened pages array in /content/docs/concepts/meta.json and meta.cn.json
  • Removed nested "Protocol Namespaces" grouping object at pages[3]
  • All protocol-* entries now at top level

Before:

{
  "pages": [
    "manifesto",
    "architecture",
    {
      "title": "Protocol Namespaces",
      "pages": ["protocol-data", "protocol-driver", ...]
    },
    "terminology"
  ]
}

After:

{
  "pages": [
    "manifesto",
    "architecture",
    "protocol-data",
    "protocol-driver",
    ...,
    "terminology"
  ]
}

Sidebar navigation will show protocol pages in sequence rather than nested under a group heading.

Original prompt

引用: https://github.com/objectstack-ai/spec/actions/runs/21345690146/job/61432691384#step:8:1


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@vercel
Copy link
Copy Markdown

vercel bot commented Jan 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
spec Error Error Jan 26, 2026 4:00am

Request Review

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
Copilot AI changed the title [WIP] Update specification references in project Fix fumadocs-mdx validation: flatten nested pages in concepts meta.json Jan 26, 2026
Copilot AI requested a review from hotlong January 26, 2026 04:00
@hotlong hotlong marked this pull request as ready for review January 26, 2026 04:32
Copilot AI review requested due to automatic review settings January 26, 2026 04:32
@hotlong hotlong merged commit 45c265f into main Jan 26, 2026
4 of 5 checks passed
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes a CI build failure by updating the fumadocs-mdx metadata structure in the concepts documentation. The nested "Protocol Namespaces" grouping structure was causing validation errors because fumadocs-mdx expects flat string arrays in the pages field, not nested objects.

Changes:

  • Flattened the pages array structure in both English and Chinese concept meta files
  • Removed the nested "Protocol Namespaces" grouping object
  • Maintained all 11 protocol pages at the top level in the same sequential order

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
content/docs/concepts/meta.json Flattened pages array from nested structure to flat list of protocol page references
content/docs/concepts/meta.cn.json Flattened pages array from nested structure to flat list (Chinese version)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants