docs-changelog

Bilingual docs changelog pages require aligned EN and ZH `.mdx` files under `docs/changelog/` with matching frontmatter fields like title, description, and tags. Both language versions must share the same key facts in the same order while localizing naturally for end users.

Required frontmatter for a product update changelog page includes at least title, description, and tags fields. The MDX file must also feature an H1 title matching the page's meaning and a concise improvements section grounded in real shipped release facts.

Docs changelog writing does not cover GitHub Release notes. It strictly ensures you only write for `docs/changelog/*.mdx` files and routes any release-note requests to the correct companion skill to prevent scope and formatting inconsistencies.

The correct filename convention for MDX changelog posts is `docs/changelog/YYYY-MM-DD-topic.mdx` for English, paired with a matching `.zh-CN.mdx` file. This maintains strict bilingual structure and aligned facts for end users.

To keep EN and ZH changelog facts consistent, treat the files as an aligned pair with the same key facts in the same order. Localize naturally while ensuring the narrative-first body and improvements section reflect identical shipped release facts.