Skip to content

Add a changelog and contributing guide, and simplify the README - #23

Merged
SumirSeth merged 1 commit into
mainfrom
docs/release-notes
Nov 7, 2026
Merged

SumirSeth merged 1 commit into
mainfrom
docs/release-notes

Conversation

@SumirSeth

Copy link
Copy Markdown
Owner

Release notes

  • CHANGELOG.md holds the user-facing notes for each release, starting with 0.5.0. Changes collect under Unreleased, and the release PR renames that section to the new version.
  • release.yml now publishes the version's CHANGELOG.md section, followed by GitHub's generated pull request list in a collapsed block. The release fails if the changelog has no section for the tag, so notes can't be forgotten.
  • .github/release.yml groups that list into New, Fixes and Under the hood by label. It leaves out PRs labelled release or skip-changelog; I've created both labels.

CONTRIBUTING.md

  • Covers the checks, Nightly, pull request titles written as changelog lines, and the writing style.
  • AI agents are welcome as code writers, tinkerers and partners for ideas. The person who opens a PR or makes a commit owns that change. Changes made end to end by an agent with no verification, testing or deliberate thought are not accepted.

README

  • Every dock action is in one table, including middle-click, right-click, the status icons and Shift+scroll, which weren't listed before.
  • Every setting is in a table, including file_search_exclude.
  • Less prose, and the contributing section now points to CONTRIBUTING.md.

Verification
I ran the new notes step locally against the v0.5.0 tag. It produced the changelog section followed by the collapsed pull request list.

🤖 Generated with Claude Code

- CHANGELOG.md holds each release's notes, starting with 0.5.0. The
  release workflow publishes the version's section, followed by the pull
  requests GitHub lists, grouped by label (.github/release.yml).
- CONTRIBUTING.md covers the checks, pull requests, writing style and
  how AI agents may be used: the person who submits a change owns it.
- The README lists every dock action, launcher command and setting in
  tables, with less prose.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@SumirSeth SumirSeth added the skip-changelog Left out of release notes label Nov 7, 2026
@SumirSeth
SumirSeth merged commit 6fd1992 into main Nov 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog Left out of release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant