Skip to content

docs: install from 0.1.0, and title release notes with the version - #21

Merged
esnunes merged 1 commit into
mainfrom
chore/post-release
Oct 4, 2026
Merged

esnunes merged 1 commit into
mainfrom
chore/post-release

Conversation

@esnunes

@esnunes esnunes commented Oct 4, 2026

Copy link
Copy Markdown
Member

Follow-ups to the first release (0.1.0), and review item 28.

Release notes

The 0.1.0 release notes were the whole git cliff --unreleased output, so they started with the changelog's # Changelog header and an ## [Unreleased] heading. tuist/sdk's workflow, which release.yml is based on, does the same. CHANGELOG.md itself was correct.

The notes step now runs git cliff --unreleased --tag "<next version>" --strip all, so a release's notes hold only its own section, titled with the version. Previewed locally on this branch:

## [0.1.1] - 2026-10-04
### Details
#### Documentation
- Install from 0.1.0, and title release notes with the version

README

  • Install line: .upToNextMinor(from: "0.1.0") replaces branch: "main", with a sentence on why. While the package is at 0.x, a minor version can break the API or the record format, and from:/.upToNextMajor would accept 0.2.0. This also lets versioned packages depend on it, which a branch dependency doesn't allow.
  • CI badge for the main workflow.
  • A License section pointing to LICENSE (MIT).

Merging this cuts 0.1.1, the first release made with the fixed notes step.

🤖 Generated with Claude Code

- release.yml: the 0.1.0 release notes were the whole `git cliff
  --unreleased` output, starting with the changelog's header and an
  "Unreleased" heading. They now hold only the new version's section,
  titled with the version (`--tag <version> --strip all`).
- README: install with `.upToNextMinor(from: "0.1.0")`, since a 0.x
  minor version can break the API or the record format; a CI badge and
  a License section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@esnunes
esnunes requested a review from a team as a code owner October 4, 2026 03:53
@esnunes
esnunes requested review from fortmarek and removed request for a team October 4, 2026 03:53
@esnunes
esnunes merged commit 889feac into main Oct 4, 2026
8 checks passed
@esnunes
esnunes deleted the chore/post-release branch October 4, 2026 06:01
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.

1 participant