Skip to content

docs(heimdall): the submitted icon was wrong, and so was my reason - #290

Merged
GeiserX merged 1 commit into
mainfrom
docs/correct-heimdall-icon-note
Aug 7, 2026
Merged

docs(heimdall): the submitted icon was wrong, and so was my reason#290
GeiserX merged 1 commit into
mainfrom
docs/correct-heimdall-icon-note

Conversation

@GeiserX

@GeiserX GeiserX commented Aug 7, 2026

Copy link
Copy Markdown
Owner

The Heimdall submission sent docs/icon.svg — a square with its own dark background plate — justified by a claim that logo.svg carried a white background.

That claim was wrong. The white rect in logo.svg is inside a <mask>, so it is never painted. The file renders fully transparent: top-left pixel srgba(0,0,0,0), mean alpha 0.35.

It came from reading the markup when one render would have settled it.

It matters because their guidance explicitly asks for transparent backgrounds, and Heimdall paints its own tile colour behind the icon — a plate fights it. PR #971 now carries the official transparent mark, verified full-bleed and transparent at their real 60px tile size.

Summary by CodeRabbit

  • Documentation
    • Updated Heimdall submission instructions to reference docs/logo.svg as the required icon.
    • Added guidance explaining the transparent rendering of the logo and Heimdall’s transparent-background requirement.

The submission sent docs/icon.svg -- a square with its own dark background
plate -- justified by a claim that logo.svg carried a white background.

That claim was wrong. The white rect in logo.svg is inside a <mask>, so it is
never painted; the file renders fully transparent, top-left pixel
srgba(0,0,0,0). It came from reading the markup when one render would have
settled it.

It matters because their guidance asks for transparent backgrounds and Heimdall
paints its own colour behind the icon, which a plate fights. The Heimdall PR now
carries the official transparent mark instead, verified full-bleed and
transparent at their 60px tile size.
@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The Heimdall submission instructions now use docs/logo.svg as the icon. The README also explains that the masked white rectangle does not render, so the icon remains transparent.

Changes

Heimdall icon documentation

Layer / File(s) Summary
Icon path and rendering correction
contrib/heimdall/README.md
The submission icon changes from docs/icon.svg to docs/logo.svg. A correction explains the transparent rendering behavior.

Estimated code review effort: 1 (Trivial) | ~3 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 summarizes the documentation correction about the Heimdall icon and the reason for the previous submission.
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 unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/correct-heimdall-icon-note

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.

@GeiserX
GeiserX merged commit e3e0975 into main Aug 7, 2026
5 of 6 checks passed
@GeiserX
GeiserX deleted the docs/correct-heimdall-icon-note branch August 7, 2026 09:01

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@contrib/heimdall/README.md`:
- Around line 70-74: Update the README wording describing logo.svg so it says
the image has a transparent background rather than claiming the entire file is
fully transparent. Preserve the top-left pixel detail as evidence of background
transparency, while keeping the visible disc description accurate.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 48a64d4e-03d7-471c-a20d-8265c20c1821

📥 Commits

Reviewing files that changed from the base of the PR and between f23965b and f9ed7ba.

📒 Files selected for processing (1)
  • contrib/heimdall/README.md

Comment on lines +70 to +74
An earlier version of this file sent `docs/icon.svg` — a square with its own
dark background plate — and justified it by claiming `logo.svg` carried a white
background. **That was wrong.** The white rect in `logo.svg` sits inside a
`<mask>`, so it is never painted; the file renders fully transparent (top-left
pixel `srgba(0,0,0,0)`).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Clarify the scope of “fully transparent.”

Line 50 describes a visible disc. The cited top-left pixel proves only that one pixel is transparent. State that logo.svg has a transparent background, not that the entire file is fully transparent.

Proposed wording
- the file renders fully transparent (top-left pixel `srgba(0,0,0,0)`).
+ the rendered icon has a transparent background (top-left pixel `srgba(0,0,0,0)`).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
An earlier version of this file sent `docs/icon.svg` — a square with its own
dark background plate — and justified it by claiming `logo.svg` carried a white
background. **That was wrong.** The white rect in `logo.svg` sits inside a
`<mask>`, so it is never painted; the file renders fully transparent (top-left
pixel `srgba(0,0,0,0)`).
An earlier version of this file sent `docs/icon.svg` — a square with its own
dark background plate — and justified it by claiming `logo.svg` carried a white
background. **That was wrong.** The white rect in `logo.svg` sits inside a
`<mask>`, so it is never painted; the rendered icon has a transparent background (top-left pixel `srgba(0,0,0,0)`).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@contrib/heimdall/README.md` around lines 70 - 74, Update the README wording
describing logo.svg so it says the image has a transparent background rather
than claiming the entire file is fully transparent. Preserve the top-left pixel
detail as evidence of background transparency, while keeping the visible disc
description accurate.

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