Skip to content

Shrink the documentation images and fix two links - #279

Merged
jnioche merged 2 commits into
mainfrom
claude/page-seo-improvements-be7c91
Sep 4, 2026
Merged

jnioche merged 2 commits into
mainfrom
claude/page-seo-improvements-be7c91

Conversation

@jnioche

@jnioche jnioche commented Sep 3, 2026

Copy link
Copy Markdown
Member

Follow-up to the SEO work in #268, #269 and #277, from a review of what those left behind.

logo.png was 359 KB of 410x477 artwork rendered at 28 CSS pixels in the header of every page, so it outweighed the HTML around it. Resized to 206x240 on a 256 colour palette it is 15 KB. The screenshots and the workflow diagram are palettised the same way: 654 KB down to 253 KB for the six of them. Console screenshot text is unaffected, the artwork loses its film grain.

social-card.png is deliberately untouched. Only scrapers fetch it, so its 785 KB costs no visitor anything, and a 256 colour palette bands its blurred backdrop badly.

Every content image now carries width and height, so the browser reserves space for it while it loads instead of reflowing the page. The theme already sets height:auto, so the attributes supply an aspect ratio rather than a fixed size.

Three different screenshots shared the alt text "AWS Console". Each now describes what is in frame.

Two link fixes: the "unlike Cloud Carbon Footprint" bullet on the home page now links to the comparison page, which is the page most likely to be searched for; and reporting/report.py no longer writes an http link into every generated report.

Checked with a zensical build --clean --strict and by rendering the pages locally: aspect ratios match the source images and nothing reflows.

logo.png was 359 KB of 410x477 artwork rendered at 28 CSS pixels in the
header of every page, so it outweighed the HTML it sits in. It is now
206x240 on a 256 colour palette, at 15 KB. The screenshots and the workflow
diagram are palettised the same way, taking the six of them from 654 KB to
253 KB. Text in the AWS console screenshots is unaffected; the artwork loses
its film grain.

social-card.png is left as it is. Only scrapers ever fetch it, so its weight
costs no visitor anything, and a 256 colour palette bands its blurred
backdrop badly.

Every content image now carries width and height so the browser can reserve
space for it while it loads. The theme sets height:auto, so the attributes
supply an aspect ratio rather than a fixed size.

Three different screenshots shared the alt text "AWS Console". Each one now
says what is in frame.
The "unlike Cloud Carbon Footprint" bullet named the project without linking
to the page that covers it, which is the page most likely to be searched for.

report.py wrote an http link to the documentation into every generated
report, one redirect away from the canonical https URL.
@jnioche
jnioche merged commit f6f5d36 into main Sep 4, 2026
1 check passed
@jnioche
jnioche deleted the claude/page-seo-improvements-be7c91 branch September 4, 2026 07:35
@jnioche jnioche added the documentation Improvements or additions to documentation label Sep 4, 2026
@jnioche jnioche added this to the 1.4 milestone Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant