Skip to content

README: clearer versioning docs for users and maintainers - #7

Merged
ubyndr merged 1 commit into
mainfrom
docs-versioning
Oct 12, 2026
Merged

ubyndr merged 1 commit into
mainfrom
docs-versioning

Conversation

@ubyndr

@ubyndr ubyndr commented Oct 12, 2026

Copy link
Copy Markdown
Collaborator

Reorganises the README so each audience can find what it needs. The file stays the same length.

Users (in "Using the plugin"):

  • install
  • set it up for a team repo: now states that each person still runs claude plugin install once
  • update: the command was never given before
  • check which version you have
  • pin a release

Maintainers:

  • "Making a change": a table of what to bump for each kind of change
  • "When a check fails": each failure message, and how to fix it

The details of how releases are automated (tags, workflows, nightly, older tags) move to the end.

Also: check-bumps now fails if __version__ disagrees with pyproject.toml. The README tells you to bump both, but nothing checked it, and cap --version prints __version__. This comes with a test.

Nothing changes under plugins/, so no version bump. ./dev.sh and check-bumps pass.

🤖 Generated with Claude Code

Users get install, team setup, update (the command was never given) and
pinning in one place, and the README no longer promises a team repo needs
no install step. Maintainers get a what-to-bump table and what each failing
check means. Release internals move to the end. Same length as before.

check-bumps now fails when a package's __version__ disagrees with its
pyproject.toml, since `cap --version` prints the former.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ubyndr
ubyndr merged commit d1e7e26 into main Oct 12, 2026
9 checks passed
@ubyndr
ubyndr deleted the docs-versioning branch October 12, 2026 15:27
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