Badge Catalog¶
docs/badges.md is the single source of truth for shared badge templates across
the repository README surfaces. Update the named templates here, then run
make sync-badges so the root README, the docs landing page, and every public
package README publish the same badge contract.
Do not hand-edit badge blocks inside README files. Those files consume the templates below through generated badge sections.
If a README surface needs package links outside the managed badge section, use plain markdown links instead of inline badge markdown.
Generated badge sections always render in this order:
- surface summary badges
- one line of
PyPIbadges for the canonical owner packages in the family - one line of
GHCRbadges for the canonical owner packages in the family - one line of
Documentationbadges for the canonical owner packages in the family
Alias package README surfaces still prioritize their own distribution badge first, then show the canonical family owner badges so the forwarding target stays visible.
Link policy for GHCR badges is fixed here as part of the contract:
- the repository-wide GHCR summary badge links to
https://github.com/bijux?tab=packages&repo_name=bijux-proteomics - per-package GHCR badges link to the package-specific
https://github.com/bijux/bijux-proteomics/pkgs/container/...page