docs-changelog

To write bilingual changelog entries, create paired EN and zh-CN MDX files in the docs/changelog directory with consistent frontmatter, including matching titles, descriptions, and tags across both language versions for ready-to-publish release notes.

Required frontmatter for changelog MDX files includes title, description, and tags. You must align these fields across paired EN and zh-CN versions to enforce frontmatter discipline and ensure proper localization of release notes.

The correct file naming convention for documentation changelogs uses date-based filenames formatted as YYYY-MM-DD-topic.mdx, requiring matching zh-CN equivalents to maintain organized and chronologically sorted EN/ZH paired release notes.

Structure release notes by following recommended document outlines and writing guidelines that ensure clarity and a consistent tone. Include a Quick Start section to produce user-friendly changelog entries that prevent release-note confusion.