Skip to content

Standardize README headers, badges, and best-practices evidence - #41

Merged
dcondrey merged 1 commit into
masterfrom
docs/repository-standards-20260901
Sep 2, 2026
Merged

Standardize README headers, badges, and best-practices evidence#41
dcondrey merged 1 commit into
masterfrom
docs/repository-standards-20260901

Conversation

@dcondrey

@dcondrey dcondrey commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • standardize every Markdown README header with a left-aligned logo and adjacent title/description
  • normalize badge geometry and category colors without hardcoding CI/security state colors
  • add or validate repository-local OpenSSF best-practices evidence
  • add only repository-supported CI, security, provenance, coverage, standards, and support badges

Badge convention

Static badges use flat-square geometry and dark-slate labelColor=20232a. Metadata is blue, standards/affiliations are purple, and support/social badges use recognizable brand colors. CI, CodeQL, OpenSSF, coverage, SLSA, and other stateful badges retain service-generated state colors.

The evidence file is intentionally conservative: criteria not provable from tracked files or repository settings remain unknown or unmet rather than being overstated.

@dcondrey
dcondrey enabled auto-merge September 2, 2026 02:03
@dcondrey
dcondrey force-pushed the docs/repository-standards-20260901 branch from f000693 to bcaeee4 Compare September 2, 2026 02:05
@dcondrey
dcondrey merged commit 73d33bc into master Sep 2, 2026
4 checks passed
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