Skip to content

profile: serve README photos as JPEG instead of WebP - #2

Open
adaptcom[bot] wants to merge 1 commit into
mainfrom
readme-images-jpg
Open

profile: serve README photos as JPEG instead of WebP#2
adaptcom[bot] wants to merge 1 commit into
mainfrom
readme-images-jpg

Conversation

@adaptcom

@adaptcom adaptcom Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #1.

Diagnosis first

The links on main are not broken. I re-rendered both surfaces in a headless browser and all four images decode:

Surface team pairing jim-casey presidio-walk
github.com/adaptcom 2558x1558 1600x1065 1101x1065 1600x1065
blob view of profile/README.md 2558x1558 1600x1065 1101x1065 1600x1065

Raw URLs return 200 with content-type: image/webp, and *.githubusercontent.com is in github.com's CSP img-src.

The broken images were almost certainly seen in the PR diff of #1, before it merged: the README pins absolute raw.githubusercontent.com/.../main/... URLs, but the files only existed on the branch at that point, so they 404'd. Browsers cache image 404s, so a hard refresh clears it. That chicken-and-egg is inherent to main-pinned absolute URLs, and relative paths are not an option because they don't resolve on the org profile page.

What this PR actually changes

WebP is not in GitHub's documented supported formats (PNG, JPG, GIF, SVG). It happens to work in current desktop web, but it's unsupported surface area for the mobile apps and third-party renderers. This re-encodes all four as progressive JPEG and repoints the README. Layout is untouched.

Also downscales the oversized originals: hero to 2000px, banner to 1600px, tiles to 1200px. 936KB -> 1.1MB (JPEG is less efficient than WebP, but these are now correctly sized rather than 2558px).

Note: the images will 404 in this PR's diff too, for the same reason as above. They resolve once merged.

WebP is not in GitHub's documented set of supported image formats
(PNG, JPG, GIF, SVG), so rendering was client-dependent. Re-encode the
four photos as progressive JPEG and repoint the README.
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.

0 participants