Skip to content

ci: write the docs changelog from changesets - #145

Merged
czaydev merged 2 commits into
mainfrom
feat/docs-changelog-from-changesets
Oct 7, 2026
Merged

czaydev merged 2 commits into
mainfrom
feat/docs-changelog-from-changesets

Conversation

@czaydev

@czaydev czaydev commented Oct 7, 2026 •

Copy link
Copy Markdown
Owner

Builds on #144; merge that first (until then this PR also shows its commit).

Before: the docs changelog (changelog.mdx / changelog.tr.mdx) was written by hand in the release PR. When it was forgotten, as in 0.8.0, Publish to NPM stopped.

After: each changeset carries its docs changelog entry in English and Turkish, and pnpm version-packages writes the new version's section into both pages, so the release PR already has it:

---
"better-payment": minor
---

Add the React Router adapter ... (CHANGELOG.md line, as before)

<!-- docs -->
en: **[React Router adapter](/docs/integrations/frameworks#react-router):** ...
tr: **[React Router adaptörü](/docs/integrations/frameworks#react-router):** ...

Entries are grouped under Added (minor), Fixed (patch) or Changed (breaking) (major); an optional section: line picks another (changed-breaking for breaking changes in 0.x). A new CI step fails a PR whose changeset has no entry. A changeset without one still releases: its summary is used on both pages.

How: scripts/docs-changelog.mjs parses the block and builds the section; version-packages.mjs reads the changesets before changeset version deletes them, inserts the sections and runs check-translations.mjs --fix for the Turkish heading ids; .changeset/changelog.cjs leaves the block out of CHANGELOG.md; scripts/check-changesets.mjs runs in CI. Tested end to end in a scratch checkout with three changesets (with a block, with section: changed-breaking, without a block); the translation check passed on the result. CONTRIBUTING (en/tr) describes the format.

Each changeset carries its docs changelog entry in English and Turkish in a
<!-- docs --> block. version-packages writes them into changelog.mdx and
changelog.tr.mdx, and CI checks that every changeset has one.
@czaydev
czaydev requested a review from poyrazavsever as a code owner October 7, 2026 04:45
Copilot AI balanced review requested due to automatic review settings October 7, 2026 04:45
@vercel

vercel Bot commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated
better-payment-web-xhgb Ready Ready Preview Oct 7, 2026 4:46am UTC

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@czaydev czaydev self-assigned this Oct 7, 2026
@czaydev
czaydev merged commit 6a12103 into main Oct 7, 2026
7 checks passed
@czaydev
czaydev deleted the feat/docs-changelog-from-changesets branch October 7, 2026 04:47

This branch was successfully deployed

1 active deployment
Preview — b1831e0b Deployed Oct 7, 2026 by vercel[bot]
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.

2 participants