Skip to content

fix: drop the header logo, which read as a second status signal - #262

Merged
shenxianpeng merged 1 commit into
mainfrom
claude/header-no-status-icon-602anc
Aug 7, 2026
Merged

fix: drop the header logo, which read as a second status signal#262
shenxianpeng merged 1 commit into
mainfrom
claude/header-no-status-icon-602anc

Conversation

@shenxianpeng

@shenxianpeng shenxianpeng commented Aug 7, 2026

Copy link
Copy Markdown
Member

The problem

Raised by @shenxianpeng looking at a failing report: is this thing telling me it passed or failed?

The org mark is a white check inside a rounded tile. GitHub's is a white check inside a rounded square. Same shape, same silhouette — only the hue differs, and hue is the weakest channel to carry meaning at 24px.

So a failing report read:

[✓ tile]  Commit Check
❌ 2 of 4 checks failed

The first symbol the eye lands on contradicts the second — and it does so exactly when the reader most needs to take the result in at a glance.

Success was fine, both symbols agreeing. That is what hid it: the ambiguity appears only on failure, which is the case that matters most and the one you see least while building the thing.

How it got here

Three changes, each locally reasonable:

header art how it read
originally wordmark badge with "COMMIT" in it a logo
#259 new wordless mark, transparent faint decoration
#261 same mark, filled tile a status chip

#261 set out to give the mark presence. Adding visual weight added semantic weight with it — that's the bit I got wrong there, and this reverses it.

What changed

The header is now plain ## Commit Check. The verdict line is the single status signal, which is the right number of them; the words carry the brand without claiming an outcome.

Also updated: the two header mockups in main.py's output-spec comment, and the two rendered previews in the README, so the documented layout matches what ships.

LOGO_URL is gone since nothing references it. assets/logo.png stays — unreferenced by this repo now, but the raw URL is public and may be linked from outside, and 2.8 KB is cheaper than a broken image somewhere I can't see.

Why not the alternatives

  • Move the mark to the footer — quieter, but a tick in a failed report's footer is still a tick. Treats the symptom.
  • Show the logo only on success — this makes the logo's presence a status signal, which is the same defect wearing a hat. The code comment says so, to stop it being "fixed" that way later.

Verification

  • Comment identity is unaffected: comments are matched on COMMENT_MARKER, an invisible HTML comment, not on the title — so existing comments are still adopted and edited in place rather than duplicated. (_find_own_comments only falls back to LEGACY_TITLES when no marked comment exists.)
  • 99 passed, black clean. The golden tests build their expected header from main.REPORT_TITLE, so they followed the change without edits — the layout is still pinned exactly.
  • Rendered a real failure report to confirm the output, rather than reasoning about the template.

🤖 Generated with Claude Code

https://claude.ai/code/session_01U9zFxq8V4qxG4aMzJhGBFn


Generated by Claude Code

Summary by CodeRabbit

  • Style
    • Simplified job summary and PR report headings by removing the Commit Check logo image.
    • Updated success and failure output examples to display a plain “Commit Check” heading.

Raised by @shenxianpeng looking at a failing report: is this thing telling
me it passed or failed?

The org mark is a white check inside a rounded tile. GitHub's ✅ is a white
check inside a rounded square. Same shape, same silhouette, differing only in
hue -- and hue is the weakest channel to carry meaning at 24px. So a failing
report opened with a tick and then said "❌ 2 of 4 checks failed": the first
symbol the eye lands on contradicted the second, and it did so exactly when
the reader most needs to take the result in at a glance.

Success was fine, both symbols agreeing. That is what hid it: the ambiguity
only appears on failure, which is the case that matters most and the one you
see least while building the thing.

Three changes walked it here, each locally reasonable. The original wordmark
badge carried "COMMIT" in it, so it read as a logo. #259 replaced it with the
new wordless mark, which was faint but still decoration. #261 filled it in to
give it presence -- and a filled tile with a check in it is not decoration, it
is a status chip. Adding visual weight added semantic weight with it.

So the header is now plain "## Commit Check". The verdict line is the single
status signal, which is the right number of them; the words carry the brand
without claiming an outcome.

assets/logo.png stays. It is unreferenced by this repo now, but the raw URL
is public and may be linked from outside, and 2.8 KB is cheaper than a broken
image somewhere I cannot see.

Comment identity is unaffected: comments are matched on COMMENT_MARKER, an
invisible HTML comment, not on the title, so existing comments are still
adopted and edited in place rather than duplicated.

The golden tests build their expected header from main.REPORT_TITLE, so they
followed the change without edits; 99 pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U9zFxq8V4qxG4aMzJhGBFn
@shenxianpeng
shenxianpeng requested a review from a team as a code owner August 7, 2026 12:10
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Commit Check

All 5 checks passed

Show all 5 checks
Commit message
  ✔ PR title (fix: drop the header logo, which read as a second status ...)
  ✔ Commit 1/1 (fix: drop the header logo, which read as a second status ...)
Branch
  ✔ Branch (claude/header-no-status-icon-602anc)
Author
  ✔ Author name (Xianpeng Shen)
  ✔ Author email (xianpeng.shen@gmail.com)

commit-check 2.13.1 · Rules reference

@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 13af94de-3a9a-46fe-b4f0-ede2644c0de8

📥 Commits

Reviewing files that changed from the base of the PR and between c6dd962 and eee7e73.

📒 Files selected for processing (2)
  • README.md
  • main.py

📝 Walkthrough

Walkthrough

The report heading no longer includes the Commit Check logo image. The code and README examples now use a plain ## Commit Check heading. The unused LOGO_URL constant and related documentation are removed.

Changes

Report heading update

Layer / File(s) Summary
Replace logo headings
main.py, README.md
REPORT_TITLE and the success and failure examples now use a plain ## Commit Check heading. LOGO_URL and its related documentation are removed.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: removing the header logo because it could be read as a second status signal.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/header-no-status-icon-602anc

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@shenxianpeng
shenxianpeng merged commit e6270e1 into main Aug 7, 2026
19 checks passed
@shenxianpeng
shenxianpeng deleted the claude/header-no-status-icon-602anc branch August 7, 2026 12:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant