History

Orkuncakilkaya f81ca5c3c1 All checks were successful bootstrap / cfree-fixpoint (push) Successful in 25s Details ci / build-and-test (push) Successful in 2m54s Details commit-lint / conventional-commits (push) Successful in 5s Details docs / build-and-deploy (push) Successful in 32s Details ci(docs): serialise the pages deploy Publishing the site force-pushes an orphan `pages` branch. Two runs racing can therefore land out of order and leave `pages` holding the older build, with both runs green and nothing to indicate the site went backwards. A `pages-deploy` concurrency group with cancel-in-progress makes a newer push cancel an older in-flight build rather than queue behind it, so the last push to land is the one that ends up published. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>		2026-09-05 03:37:33 +03:00
..
ci-runner-dns.md	docs(ci): document the runner network a self-hosted CI needs	2026-09-05 02:57:09 +03:00
docs-deploy-concurrency.md	ci(docs): serialise the pages deploy	2026-09-05 03:37:33 +03:00
README.md	fix(release): keep a changeset's markdown in the changelog	2026-09-05 01:47:49 +03:00

README.md

Changesets

A changeset is one small Markdown file describing a single user-facing change, dropped in this directory. x release consumes every changeset here into a new CHANGELOG.md section, bumps VERSION, and deletes the consumed files.

Format

bump: minor
type: feat
One or more lines describing the change, in the past-agnostic imperative used in
the changelog. Markdown is fine.

bump: — major, minor, or patch (SemVer). The release version is bumped by the highest level among the pending changesets (unless x release <level> overrides it).
type: — the Conventional Commit type (feat, fix, perf, docs, …). It decides which group the change lands in: feat → Features, fix → Fixes, perf → Performance, and so on, in that order. A type with no known heading gets one named after itself.

Writing the body

The body is markdown and reaches the changelog as markdown: it becomes one list item, with continuation lines indented to stay inside it. Nested bullets, blank lines between paragraphs and inline code all survive.

bump: minor
type: feat
**Tiled map support** — load and draw Tiled maps.

- **TMX/TSX** — the XML formats, decoded to the same intermediate as JSON.
- **Collision** — the `collision` layer projects onto the engine tilemap.

Lead with the thing that changed, not with the mechanism. A reader scanning the release should be able to stop after your first clause.

Adding one

Create a file with a short, unique name, e.g. changes/regex-namespace.md. Any filename works except this README.md, which the release step always skips.

Preview how the next release will read before cutting it — this writes nothing:

x release --dry-run