Skip to content

Feature: unified semantic-dom title in the docs#1877

Open
Rain120 wants to merge 14 commits into
ant-design:mainfrom
Rain120:feature/docs-unified_semantic
Open

Feature: unified semantic-dom title in the docs#1877
Rain120 wants to merge 14 commits into
ant-design:mainfrom
Rain120:feature/docs-unified_semantic

Conversation

@Rain120
Copy link
Copy Markdown
Contributor

@Rain120 Rain120 commented Apr 23, 2026

🤔 Unified semantic-dom title in the Chinese docs

  • 🆕 New feature
  • 🐞 Bug fix
  • 📝 Site / documentation improvement
  • 📽️ Demo improvement
  • 💄 Component style improvement
  • 🤖 TypeScript definition improvement
  • 📦 Bundle size optimization
  • ⚡️ Performance optimization
  • ⭐️ Feature enhancement
  • 🌐 Internationalization
  • 🛠 Refactoring
  • 🎨 Code style optimization
  • ✅ Test Case
  • 🔀 Branch merge
  • ⏩ Workflow
  • ⌨️ Accessibility improvement
  • ❓ Other (about what?)

💡 Background and Solution

Background

All of the Chinese docs are named 'Semantic DOM', but file-card and folder are special

image

Solution

Make them unified to be 'Semantic DOM'.

Summary by CodeRabbit

发布说明

  • 文档

    • 将文档中“语义化 DOM”节标题改为英文“Semantic DOM”。
  • Chores

    • 多个技能组件版本升级至 2.6.0。
    • 调整技能标签分类:移除部分组件的 agent 标签并将若干组件标签统一为 sdk

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 23, 2026

Preview is ready

@dosubot dosubot Bot added the documentation Improvements or additions to documentation label Apr 23, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 23, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: f746e90d-cd9b-42af-b738-cf9d630c367d

📥 Commits

Reviewing files that changed from the base of the PR and between dd5eda3 and 2b841cd.

📒 Files selected for processing (2)
  • packages/x-skill/skills-zh/x-components/reference/API.md
  • packages/x-skill/src/skill-meta.json
✅ Files skipped from review due to trivial changes (2)
  • packages/x-skill/skills-zh/x-components/reference/API.md
  • packages/x-skill/src/skill-meta.json

📝 Walkthrough

Walkthrough

将若干中文文档章节标题由“语义化 DOM”统一改为英文 “Semantic DOM”,并将 packages/x-skill/src/skill-meta.json 中六个技能的版本从 2.5.0 升级至 2.6.0,同时调整部分技能的 tags 配置。

Changes

Cohort / File(s) Summary
文档标题本地化
packages/x-skill/skills-zh/x-components/reference/API.md, packages/x/components/file-card/index.zh-CN.md, packages/x/components/folder/index.zh-CN.md
将文档章节标题从中文 语义化 DOM 统一改为英文 Semantic DOM(仅文本标题替换,内容与示例无变更)。
技能元数据版本升级
packages/x-skill/src/skill-meta.json
将六个技能(use-x-chatx-cardx-chat-providerx-requestx-componentsx-markdown)的 version2.5.0 升级为 2.6.0;调整 tagsuse-x-chat 移除 agentx-componentsx-markdown 的 tags 更新为 ["sdk"],其它 tags 保持或未变。

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 标题换了新衣,英语轻声来访,
版本跃升零点六,技能整装待发,
文档一处一处改,细节静默闪光,
小兔拍掌欢喜,祝改动稳又长。

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: unifying semantic DOM section titles from Chinese to English across multiple documentation files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request translates "语义化 DOM" to "Semantic DOM" in documentation and updates versions and tags in skill-meta.json. Feedback suggests that the changes to skill-meta.json are out of scope and reduce metadata granularity. Additionally, renaming multiple headers to "Semantic DOM" in API.md creates duplicate anchors that may break documentation navigation.

Comment thread packages/x-skill/src/skill-meta.json Outdated
Comment thread packages/x-skill/skills-zh/x-components/reference/API.md
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/x-skill/skills-zh/x-components/reference/API.md`:
- Line 811: 当前文件中存在重复的同级标题 "## Semantic DOM"(触发
MD024/no-duplicate-heading);请在重复的标题处将其中一个改为唯一化(例如改为 "## Semantic DOM — <组件名>" 或
"### Semantic DOM"
以改变层级),并同步更新任何引用该标题的锚点或链接(检查文档内的跳转/目录引用);确保保留语义并在标题文本中加入组件前缀或其它区分信息以避免再次重复。

In `@packages/x-skill/src/skill-meta.json`:
- Line 20: 当前问题是 skill 元数据里的领域标签被覆盖为仅 ["sdk"],导致检索召回精度下降;在生成元信息的逻辑(参见
generate-meta.ts)应保留并合并输入 metadata 中的 tags 而不是只按名称生成通用标签。请修改 generate-meta.ts
中构建 tags 的处所(例如处理 skill-meta.json 的生成函数)以:1) 读取原始 input.metadata.tags(若存在),2) 与按
name 生成的默认标签合并,3) 去重并保证顺序稳定,最后写回 skill-meta.json;并把相同处理应用到其他受影响的生成逻辑以修复
x-card/x-components/x-markdown 等。
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: d1aff391-5a40-45c9-a420-5d8ca6ebe462

📥 Commits

Reviewing files that changed from the base of the PR and between c5d7f37 and dd5eda3.

📒 Files selected for processing (4)
  • packages/x-skill/skills-zh/x-components/reference/API.md
  • packages/x-skill/src/skill-meta.json
  • packages/x/components/file-card/index.zh-CN.md
  • packages/x/components/folder/index.zh-CN.md

Comment thread packages/x-skill/skills-zh/x-components/reference/API.md Outdated
Comment thread packages/x-skill/src/skill-meta.json Outdated
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 23, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.47%. Comparing base (c5d7f37) to head (2b841cd).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1877   +/-   ##
=======================================
  Coverage   97.47%   97.47%           
=======================================
  Files         158      158           
  Lines        5505     5505           
  Branches     1610     1611    +1     
=======================================
  Hits         5366     5366           
  Misses        137      137           
  Partials        2        2           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 23, 2026

Bundle Report

Changes will increase total bundle size by 1.48MB (40.51%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name Size Change
x-markdown-array-push 1.61MB 1.48MB (1194.85%) ⬆️⚠️
antdx-array-push 3.53MB 80 bytes (0.0%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: x-markdown-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
latex.js (New) 504.07kB 504.07kB 100.0% 🚀
static/KaTeX_AMS-Regular.*.ttf (New) 63.63kB 63.63kB 100.0% 🚀
static/KaTeX_Main-Regular.*.ttf (New) 53.58kB 53.58kB 100.0% 🚀
static/KaTeX_Main-Bold.*.ttf (New) 51.34kB 51.34kB 100.0% 🚀
static/KaTeX_Main-Italic.*.ttf (New) 33.58kB 33.58kB 100.0% 🚀
static/KaTeX_AMS-Regular.*.woff (New) 33.52kB 33.52kB 100.0% 🚀
static/KaTeX_Main-BoldItalic.*.ttf (New) 32.97kB 32.97kB 100.0% 🚀
static/KaTeX_Math-Italic.*.ttf (New) 31.31kB 31.31kB 100.0% 🚀
static/KaTeX_Math-BoldItalic.*.ttf (New) 31.2kB 31.2kB 100.0% 🚀
static/KaTeX_Main-Regular.*.woff (New) 30.77kB 30.77kB 100.0% 🚀
static/KaTeX_Main-Bold.*.woff (New) 29.91kB 29.91kB 100.0% 🚀
static/KaTeX_AMS-Regular.*.woff2 (New) 28.08kB 28.08kB 100.0% 🚀
static/KaTeX_Typewriter-Regular.*.ttf (New) 27.56kB 27.56kB 100.0% 🚀
static/KaTeX_Main-Regular.*.woff2 (New) 26.27kB 26.27kB 100.0% 🚀
static/KaTeX_Main-Bold.*.woff2 (New) 25.32kB 25.32kB 100.0% 🚀
static/KaTeX_SansSerif-Bold.*.ttf (New) 24.5kB 24.5kB 100.0% 🚀
latex.css (New) 24.39kB 24.39kB 100.0% 🚀
static/KaTeX_SansSerif-Italic.*.ttf (New) 22.36kB 22.36kB 100.0% 🚀
static/KaTeX_Main-Italic.*.woff (New) 19.68kB 19.68kB 100.0% 🚀
static/KaTeX_Fraktur-Bold.*.ttf (New) 19.58kB 19.58kB 100.0% 🚀
static/KaTeX_Fraktur-Regular.*.ttf (New) 19.57kB 19.57kB 100.0% 🚀
static/KaTeX_SansSerif-Regular.*.ttf (New) 19.44kB 19.44kB 100.0% 🚀
static/KaTeX_Main-BoldItalic.*.woff (New) 19.41kB 19.41kB 100.0% 🚀
static/KaTeX_Math-Italic.*.woff (New) 18.75kB 18.75kB 100.0% 🚀
static/KaTeX_Math-BoldItalic.*.woff (New) 18.67kB 18.67kB 100.0% 🚀
static/KaTeX_Main-Italic.*.woff2 (New) 16.99kB 16.99kB 100.0% 🚀
static/KaTeX_Main-BoldItalic.*.woff2 (New) 16.78kB 16.78kB 100.0% 🚀
static/KaTeX_Script-Regular.*.ttf (New) 16.65kB 16.65kB 100.0% 🚀
static/KaTeX_Math-Italic.*.woff2 (New) 16.44kB 16.44kB 100.0% 🚀
static/KaTeX_Math-BoldItalic.*.woff2 (New) 16.4kB 16.4kB 100.0% 🚀
static/KaTeX_Typewriter-Regular.*.woff (New) 16.03kB 16.03kB 100.0% 🚀
static/KaTeX_SansSerif-Bold.*.woff (New) 14.41kB 14.41kB 100.0% 🚀
static/KaTeX_SansSerif-Italic.*.woff (New) 14.11kB 14.11kB 100.0% 🚀
static/KaTeX_Typewriter-Regular.*.woff2 (New) 13.57kB 13.57kB 100.0% 🚀
static/KaTeX_Fraktur-Bold.*.woff (New) 13.3kB 13.3kB 100.0% 🚀
static/KaTeX_Fraktur-Regular.*.woff (New) 13.21kB 13.21kB 100.0% 🚀
static/KaTeX_Caligraphic-Bold.*.ttf (New) 12.37kB 12.37kB 100.0% 🚀
static/KaTeX_Caligraphic-Regular.*.ttf (New) 12.34kB 12.34kB 100.0% 🚀
static/KaTeX_SansSerif-Regular.*.woff (New) 12.32kB 12.32kB 100.0% 🚀
static/KaTeX_Size1-Regular.*.ttf (New) 12.23kB 12.23kB 100.0% 🚀
static/KaTeX_SansSerif-Bold.*.woff2 (New) 12.22kB 12.22kB 100.0% 🚀
static/KaTeX_SansSerif-Italic.*.woff2 (New) 12.03kB 12.03kB 100.0% 🚀
static/KaTeX_Size2-Regular.*.ttf (New) 11.51kB 11.51kB 100.0% 🚀
static/KaTeX_Fraktur-Bold.*.woff2 (New) 11.35kB 11.35kB 100.0% 🚀
static/KaTeX_Fraktur-Regular.*.woff2 (New) 11.32kB 11.32kB 100.0% 🚀
static/KaTeX_Script-Regular.*.woff (New) 10.59kB 10.59kB 100.0% 🚀
static/KaTeX_Size4-Regular.*.ttf (New) 10.36kB 10.36kB 100.0% 🚀
static/KaTeX_SansSerif-Regular.*.woff2 (New) 10.34kB 10.34kB 100.0% 🚀
static/KaTeX_Script-Regular.*.woff2 (New) 9.64kB 9.64kB 100.0% 🚀
static/KaTeX_Caligraphic-Bold.*.woff (New) 7.72kB 7.72kB 100.0% 🚀
static/KaTeX_Caligraphic-Regular.*.woff (New) 7.66kB 7.66kB 100.0% 🚀
static/KaTeX_Size3-Regular.*.ttf (New) 7.59kB 7.59kB 100.0% 🚀
static/KaTeX_Caligraphic-Bold.*.woff2 (New) 6.91kB 6.91kB 100.0% 🚀
static/KaTeX_Caligraphic-Regular.*.woff2 (New) 6.91kB 6.91kB 100.0% 🚀
static/KaTeX_Size1-Regular.*.woff (New) 6.5kB 6.5kB 100.0% 🚀
static/KaTeX_Size2-Regular.*.woff (New) 6.19kB 6.19kB 100.0% 🚀
static/KaTeX_Size4-Regular.*.woff (New) 5.98kB 5.98kB 100.0% 🚀
static/KaTeX_Size1-Regular.*.woff2 (New) 5.47kB 5.47kB 100.0% 🚀
static/KaTeX_Size2-Regular.*.woff2 (New) 5.21kB 5.21kB 100.0% 🚀
static/KaTeX_Size4-Regular.*.woff2 (New) 4.93kB 4.93kB 100.0% 🚀
static/KaTeX_Size3-Regular.*.woff (New) 4.42kB 4.42kB 100.0% 🚀
static/KaTeX_Size3-Regular.*.woff2 (New) 3.62kB 3.62kB 100.0% 🚀
x-markdown.min.js (Deleted) -117.45kB 0 bytes -100.0% 🗑️
x-markdown.min.css (Deleted) -6.5kB 0 bytes -100.0% 🗑️
view changes for bundle: antdx-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
antdx.js 80 bytes 3.53MB 0.0%

@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Apr 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation lgtm This PR has been approved by a maintainer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants