Skip to content

docs: badge-ify license / deps / why-this-matters to match ci + OpenSSF#41

Merged
askalf merged 2 commits into
mainfrom
docs/badge-row-consistency
Jul 11, 2026
Merged

docs: badge-ify license / deps / why-this-matters to match ci + OpenSSF#41
askalf merged 2 commits into
mainfrom
docs/badge-row-consistency

Conversation

@askalf

@askalf askalf commented Jul 11, 2026

Copy link
Copy Markdown
Owner

What

The README header had two rendered SVG badges (ci, OpenSSF Scorecard) followed by plain grey text — MIT · one runtime dependency · why this matters →. On npm that reads as two colored shields trailing off into unstyled text. This converts the three trailing items into flat shields.io badges so the header is one consistent badge row.

item before after
license plain text MIT license | MIT (blue shield → LICENSE)
deps plain text one runtime dependency runtime deps | 3 (green shield → package.json)
why text link why this matters → why this matters | the lethal trifecta (violet shield → the doc)

All five badges now use the same flat style as the existing ci / OpenSSF Scorecard badges.

Note — dependency count corrected 1 → 3

package.json lists three dependencies (@modelcontextprotocol/sdk, node-html-parser, zod); sdk+zod moved from optional to regular when the MCP server shipped, so "one runtime dependency" was stale. The badge reflects the real count so it can't be contradicted by npm's own dependency list.

Reach npm

npm only refreshes the displayed README on a new publish — this rides the next release.

askalf added 2 commits July 11, 2026 12:46
The MIT, dependency, and "why this matters" items were plain text after
the two SVG badges, so on npm they rendered as grey text trailing two
colored shields. Convert them to flat shields.io badges (same flat style
as the ci and OpenSSF Scorecard badges) so the header reads as one
consistent badge row.

Also corrects the dependency count 1 -> 3: @modelcontextprotocol/sdk and
zod became regular dependencies (from optional) when the MCP server
shipped, so "one runtime dependency" was stale.
@askalf askalf merged commit fb8a74b into main Jul 11, 2026
4 checks passed
@askalf askalf deleted the docs/badge-row-consistency branch July 11, 2026 16:50
@askalf askalf mentioned this pull request Jul 11, 2026
askalf added a commit that referenced this pull request Jul 11, 2026
Docs-only patch so the README badge-row fix (#41) reaches the npm-displayed
README. Bumps package.json + package-lock.json 0.4.0 -> 0.4.1 and stamps
CHANGELOG [0.4.1].
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