Skip to content

docs: add badges to the README - #19

Merged
tschm merged 1 commit into
mainfrom
docs/readme-badges
Aug 30, 2026
Merged

docs: add badges to the README#19
tschm merged 1 commit into
mainfrom
docs/readme-badges

Conversation

@tschm

@tschm tschm commented Aug 30, 2026

Copy link
Copy Markdown
Member

Five shields.io badges under the # Fleet monitoring heading.

Badge Links to Source of truth
CI actions/workflows/ci.yml live workflow status on main
book actions/workflows/book.yml live workflow status on main
Docs https://jebel-quant.github.io/monitoring/ site_url in mkdocs.yml
Python 3.11+ collector/pyproject.toml its requires-python = ">=3.11"
License LICENSE MIT

All five are shields.io rather than GitHub's native badge.svg for the two workflows, so the row renders in one consistent style instead of two. The three dynamic ones were fetched against this repo before committing and return CI: passing, book: passing, license: MIT — a wrong workflow filename would have rendered "no status".

Book and Docs are deliberately separate. The book badge reports a build gate: strict: true in mkdocs.yml turns a broken relative link into a failed build, which book.yml's own comments call the most likely way these docs rot. The Docs badge is a doorway to the published site. Different jobs, so both earn a slot — happy to collapse them if you'd rather have four.

No version badge. The repo has no tags and declares no version location (no [tool.bumpversion], no root manifest), so one would either read "no releases" or hardcode a number nothing enforces. Worth adding once that's settled.

The Python badge is static — shields has no reader for a nested manifest's requires-python — so it needs a manual edit if the collector's floor moves. The other four update themselves.

Docs-only change: README.md, +6 lines, no code touched.

🤖 Generated with Claude Code

Five shields.io badges under the heading, rather than GitHub's native
badge.svg for the two workflows, so the row renders in one consistent
style instead of two.

Book and Docs stay separate on purpose: the book badge reports a build
gate - `strict: true` in mkdocs.yml fails on a broken relative link -
while the Docs badge is a doorway to the published site.

No version badge. The repo has no tags and declares no version location,
so one would either read "no releases" or hardcode a number nothing
enforces.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@tschm
tschm merged commit a881a66 into main Aug 30, 2026
3 checks passed
@tschm
tschm deleted the docs/readme-badges branch August 30, 2026 12:12
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