ci: shorten workflow display names so the README badges fit (ADR-1227) - #1390
Merged
Conversation
GitHub's badge.svg endpoint paints the workflow `name:` into the badge, so the seven status badges at the top of README.md rendered whatever the workflow was called. Under ADR-0116 §2 that meant 60-to-70-character banners: Tests & Quality Gates — Netflix Golden / Sanitizers / Tiny AI / Coverage Security Scans — Semgrep / CodeQL / Gitleaks / Dependency Review libvmaf Build Matrix — Linux/macOS/Windows/ARM × CPU/SYCL/CUDA Upstream watcher — FFmpeg HIP hwdec (closes T-FFMPEG-HIP-FILTER-DEFERRED) which wrapped the README header across several lines and crowded the Actions sidebar and `gh run list`. docs/development/ci-job-names.md already imposed a <=30-character budget on job display names for exactly this class of reason; workflow names were never brought under it. ADR-1227 extends it there, superseding ADR-0116 §2 (workflow `name:` only) and leaving every other clause of ADR-0116 standing. Fourteen workflows relabelled. The four the README badges point at -- Tests, Security, Builds, FFmpeg -- are now named exactly as their badge link labels, so the badge text and the link text finally agree. The axis list each name carried moves to a comment under the `name:` line, where it does not have to fit in a badge. Filenames are untouched: badge and Actions URLs key on the filename, so this is label-only. No badge URL churn, no branch-protection re-pin (the single required context is a job name, not a workflow name), and no `workflow_run` trigger references any renamed workflow. check-aggregator-names.sh still reports all 35 required checks matching. Refs: ADR-1227 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
GitHub's
badge.svgendpoint paints the workflowname:into the badge, sothe seven status badges at the top of the README render whatever the workflow is
called. Under ADR-0116 §2 that meant 60–70-character banners:
which wrapped the README header across several lines and crowded the Actions
sidebar and
gh run list.docs/development/ci-job-names.mdalready imposed a ≤30-character budget onjob display names for exactly this reason; workflow names were never brought
under it. ADR-1227 extends it
there, superseding ADR-0116 §2 (workflow
name:only) and leaving everyother clause standing.
Fourteen workflows relabelled. The four the README badges point at —
Tests,Security,Builds,FFmpeg— are now named exactly as their badge linklabels, so the badge text and the link text finally agree. The axis list each
name carried moves to a comment under the
name:line, where it doesn't have tofit in a badge:
Filenames are untouched. Badge and Actions URLs key on the filename, so this
is label-only: no badge URL churn, no branch-protection re-pin (the single
required context is a job name, not a workflow name), and no
workflow_runtrigger references any renamed workflow.
Reproducer / smoke-test command
Deep-dive deliverables (ADR-0108)
badge.svgrenders the workflow name) and the fix is a label edit.## Alternatives considered(four options, including dropping the badges and abbreviating the axis list).AGENTS.mdinvariant note — no rebase-sensitive invariants; the non-obvious constraint (filenames are URL-bearing, names are not) is in the ADR and the ci-job-names doc.changelog.d/changed/1227-short-workflow-display-names.md,CHANGELOG.mdregenerated.Docs (rule 10)
docs/development/ci-job-names.mdgains a"Workflow display names (ADR-1227)" section documenting the budget, why it is
sharper for workflow names than job names, and that filenames are exempt because
they are URL-bearing.
State (rule 13)
no state delta: CI metadata, no bug opened or closed.
🤖 Generated with Claude Code