Skip to content

docs: show the release as a badge instead of naming it in prose - #13

Closed
kkdev92 wants to merge 1 commit into
mainfrom
docs/stop-version-drift
Closed

docs: show the release as a badge instead of naming it in prose#13
kkdev92 wants to merge 1 commit into
mainfrom
docs/stop-version-drift

Conversation

@kkdev92

@kkdev92 kkdev92 commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Replaces the hand-written version in the status line with a release badge.

Why

The status line said 0.1.0. That is accurate today and wrong the day the next
release is tagged, and nothing fails in between — the reader is the one who
finds out.

Why a badge rather than just deleting it

The sibling repositories all carry a package-registry badge, so removing the
number from their prose loses nothing. This one is firmware, not a published
package, so there was no badge to fall back on — deleting the number would have
removed the information rather than moved it.

A GitHub release badge reads from this repository's own releases. It cannot
disagree with them, and it needs no maintenance.

Verification

The badge URL resolves and renders v0.1.0, which is the current tag.

🤖 Generated with Claude Code

The status line said `0.1.0`. That is correct today and wrong the day the next
release is tagged, and nothing fails in between -- the reader is the one who
finds out.

Unlike the other repositories here, this one had no version badge to fall back
on: it is firmware rather than a published package, so removing the number
would have removed the information. A release badge replaces it. It reads from
the repository's own releases, so it cannot disagree with them.

Verified: the badge resolves and renders `v0.1.0`, which is the current tag.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Tfbt5Vy1jB9C6mMAHXhLY
@kkdev92 kkdev92 closed this Sep 2, 2026
@kkdev92
kkdev92 deleted the docs/stop-version-drift branch September 2, 2026 11:58
@kkdev92

kkdev92 commented Sep 2, 2026

Copy link
Copy Markdown
Owner Author

Closed as wrong.

The invariants check already holds the status line to PROJECT_VER, and it reported exactly that: the status line says Active; PROJECT_VER is 0.1.0, and PROJECT_VER is what device.describe reports.

That last clause is the point. The version in the README is not a label on the page — it is the value the firmware reports over the wire, so the README and the device would have disagreed. Removing it defeats a check that exists for a reason.

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