Skip to content

Show a release and build badge for each language, not just Python - #9

Merged
samuelduchesne merged 1 commit into
mainfrom
docs/badges-for-both-languages
Sep 7, 2026
Merged

Show a release and build badge for each language, not just Python#9
samuelduchesne merged 1 commit into
mainfrom
docs/badges-for-both-languages

Conversation

@samuelduchesne

Copy link
Copy Markdown
Contributor

The home page carried four badges and all four pointed at idfkit/idfkit. A site whose premise is that two libraries hold the same standing over every page should not advertise one of them and omit the other.

The row, before and after

Before After
Release (idfkit) python release, python build
Build status (idfkit) typescript release, typescript build
Commit activity (idfkit) License
License (idfkit)

Three things worth reviewing

The TypeScript release badge filters on v*. The newest GitHub release in idfkit-js is docs-2026.3, a documentation artifact rather than a library version, so an unfiltered badge reports docs-2026.3 as the version of the library. With the filter it reports v0.2.0.

Labels are set in the URL. A shield does not read the Markdown alt text, so ?label=python%20release is what makes the two releases distinguishable.

Commit activity is gone rather than duplicated. Five badges is already a full row and it said the least of the four. Easy to restore on both sides if you would rather keep it.

Two of the old badges linked to img.shields.io rather than to the releases or the licence they described. Both now link somewhere a reader can use.

The README had no badges at all, so it gains the row idfkit's own README uses: both library releases, this repository's own docs build, its licence.

A judgment call left open

The Python release badge reads v0.15.0 while the site is pinned to build against 1.0.0-rc.3, because the 1.0.0 line is all pre-releases. Adding &include_prereleases to both badges would show v1.0.0-rc.3 and v0.3.0-rc.2 instead. That is a question about what the home page should advertise during a release candidate, so I kept the existing stable-only rule rather than change it silently.

Checks

  • Every badge URL fetched and confirmed to render the expected text: python release: v0.15.0, python build: passing, typescript release: v0.2.0, typescript build: passing, docs: passing, license: MIT.
  • make check passes.
  • The built index.html carries all five badges, with & escaped correctly.
  • make docs-test fails locally at 108 warnings, identically on a stashed baseline: a missing local libcairo that the social-card plugin wants, untouched by this change. CI has the library.

The site's home page carried four badges, all of them pointing at
idfkit/idfkit. A site whose premise is that two libraries hold the same
standing over every page should not advertise one of them and omit the
other.

The row is now symmetric: a release and a build badge per language, plus
the licence. The TypeScript release badge filters on v*, because the
newest GitHub release in idfkit-js is docs-2026.3, a documentation
artifact rather than a library version, and shields would otherwise
report that as the version. Labels move into the URL, since alt text does
not reach a rendered shield.

Commit activity is gone rather than duplicated: five badges is a full
row, and it said the least of the four. Two badges linked to
img.shields.io instead of to the thing they described; both now link
somewhere a reader can use.

The README had no badges at all, so it gains the row idfkit's own README
uses: both library releases, this repository's docs build, its licence.
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Docs preview for this PR is available at:
https://developers.idfkit.com/pr-preview/pr-9/

Changed pages:

github-actions Bot added a commit that referenced this pull request Sep 7, 2026
@samuelduchesne
samuelduchesne merged commit ef3fabc into main Sep 7, 2026
6 checks passed
@samuelduchesne
samuelduchesne deleted the docs/badges-for-both-languages branch September 7, 2026 03:37
github-actions Bot added a commit that referenced this pull request Sep 7, 2026
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