Skip to content

docs: Update documentation and improve frontmatter references#3009

Merged
SoonIter merged 6 commits intomainfrom
syt/upgrade-doc
Jan 15, 2026
Merged

docs: Update documentation and improve frontmatter references#3009
SoonIter merged 6 commits intomainfrom
syt/upgrade-doc

Conversation

@SoonIter
Copy link
Copy Markdown
Member

Enhance documentation clarity by updating frontmatter-related content and improving MDX explanations. Adjusted type annotations for consistency and clarity in the codebase.

Copilot AI review requested due to automatic review settings January 15, 2026 08:14
@netlify
Copy link
Copy Markdown

netlify bot commented Jan 15, 2026

Deploy Preview for rspress-v2 ready!

Name Link
🔨 Latest commit 96af720
🔍 Latest deploy log https://app.netlify.com/projects/rspress-v2/deploys/6968ac25e634fc0008f07eba
😎 Deploy Preview https://deploy-preview-3009--rspress-v2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Jan 15, 2026

Rsdoctor Bundle Diff Analysis

Found 3 projects in monorepo, 3 projects with changes.

📊 Quick Summary
Project Total Size Change
node 10.5 MB +16.7 KB (0.2%)
node_md 1.3 MB +8.5 KB (0.6%)
web 15.9 MB +22.7 KB (0.1%)
📋 Detailed Reports (Click to expand)

📁 node

Path: website/doc_build/diff-rsdoctor/node/rsdoctor-data.json

📌 Baseline Commit: 4d0815f8e5 | PR: #3006

Metric Current Baseline Change
📊 Total Size 10.5 MB 10.4 MB +16.7 KB (0.2%)
📄 JavaScript 0 B 0 B 0
🎨 CSS 0 B 0 B 0
🌐 HTML 10.5 MB 10.4 MB +16.7 KB (0.2%)
📁 Other Assets 0 B 0 B 0

📦 Download Diff Report: node Bundle Diff

📁 node_md

Path: website/doc_build/diff-rsdoctor/node_md/rsdoctor-data.json

📌 Baseline Commit: 4d0815f8e5 | PR: #3006

Metric Current Baseline Change
📊 Total Size 1.3 MB 1.3 MB +8.5 KB (0.6%)
📄 JavaScript 0 B 0 B 0
🎨 CSS 0 B 0 B 0
🌐 HTML 0 B 0 B 0
📁 Other Assets 1.3 MB 1.3 MB +8.5 KB (0.6%)

📦 Download Diff Report: node_md Bundle Diff

📁 web

Path: website/doc_build/diff-rsdoctor/web/rsdoctor-data.json

📌 Baseline Commit: 4d0815f8e5 | PR: #3006

Metric Current Baseline Change
📊 Total Size 15.9 MB 15.9 MB +22.7 KB (0.1%)
📄 JavaScript 15.1 MB 15.1 MB +18.4 KB (0.1%)
🎨 CSS 126.3 KB 126.3 KB 0
🌐 HTML 0 B 0 B 0
📁 Other Assets 715.1 KB 710.8 KB +4.3 KB (0.6%)

📦 Download Diff Report: web Bundle Diff

Generated by Rsdoctor GitHub Action

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 pull request enhances documentation clarity by updating frontmatter-related content across both Chinese and English documentation files. The changes standardize type annotation formatting, add cross-references between related documentation pages, improve MDX explanations, and reorganize configuration documentation for better readability.

Changes:

  • Standardized type annotation formatting from Type: to **Type**: across all configuration documentation files
  • Added cross-references linking frontmatter documentation with the useFrontmatter hook and vice versa
  • Enhanced MDX documentation with better explanations and practical examples including component imports
  • Reorganized config-frontmatter.mdx to group related configurations (Overview Page Related, Home Page Related sections)
  • Updated Border component styling to use a lighter divider color variable

Reviewed changes

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

Show a summary per file
File Description
website/docs/zh/ui/hooks/use-frontmatter.mdx Added link to frontmatter config documentation
website/docs/zh/guide/use-mdx/frontmatter.mdx Enhanced examples and added useFrontmatter reference
website/docs/zh/guide/use-mdx/components.mdx Improved MDX explanation with practical component example
website/docs/zh/api/config/config-theme.mdx Standardized type annotation formatting
website/docs/zh/api/config/config-frontmatter.mdx Reorganized sections, standardized formatting, added cross-references
website/docs/en/ui/hooks/use-frontmatter.mdx Added link to frontmatter config documentation
website/docs/en/plugin/system/plugin-api.mdx Standardized type annotation formatting
website/docs/en/plugin/official-plugins/typedoc.mdx Standardized type annotation formatting
website/docs/en/plugin/official-plugins/algolia.mdx Standardized type annotation formatting
website/docs/en/guide/use-mdx/frontmatter.mdx Enhanced examples and added useFrontmatter reference
website/docs/en/guide/use-mdx/components.mdx Improved MDX explanation with practical component example
website/docs/en/api/config/config-theme.mdx Standardized type annotation formatting
website/docs/en/api/config/config-frontmatter.mdx Reorganized sections, standardized formatting, improved feature descriptions
website/docs/en/api/config/config-build.mdx Standardized default value formatting
website/docs/components/Border.tsx Updated divider color CSS variable

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@SoonIter
Copy link
Copy Markdown
Member Author

@copilot open a new pull request to apply changes based on the comments in this thread

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 15, 2026

@SoonIter I've opened a new pull request, #3010, to work on those changes. Once the pull request is ready, I'll request review from you.

SoonIter and others added 2 commits January 15, 2026 16:21
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: SoonIter <79413249+SoonIter@users.noreply.github.com>
@SoonIter SoonIter enabled auto-merge (squash) January 15, 2026 09:11
@SoonIter SoonIter requested a review from Timeless0911 January 15, 2026 09:11
@SoonIter SoonIter merged commit 2546e80 into main Jan 15, 2026
8 checks passed
@SoonIter SoonIter deleted the syt/upgrade-doc branch January 15, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants