From de8f197a7f5f8e83cb58607c05c788a7e8846057 Mon Sep 17 00:00:00 2001 From: Dan Gold Date: Thu, 17 Sep 2026 18:15:31 -0700 Subject: [PATCH] og: rename the card to og-v2.png and put the social tags on one line each Every item on the standard Slack checklist already passed -- tags present and absolute, page 2990 bytes against a 32KB limit, no robots.txt, publicly reachable, full TLS chain, no redirects -- and Facebook, LinkedIn and opengraph.xyz all resolve the image. Only Slack does not. Two changes, for the two things that could still explain it. Rename to og-v2.png. Slack caches the image separately from the page, keyed on the image URL, so busting the page URL does not touch it. If its proxy tried og-v1.png while a region was still serving the old container it would have cached that 404. A new filename is a guaranteed miss, which is what versioning it was for. Put every social tag on a single line and move the block to the top of the head. Prettier had wrapped og:image:alt and twitter:image:alt across three lines. A proper HTML parser does not care, which is why the validators pass, but og:image:alt is a sub-property of og:image, and a line-oriented scraper that trips on it can drop the whole image property. Also adds og:image:secure_url, which is redundant over https but harmless. The smoke test asserted /og-v1.png, so it moves with the rename. Verified against the built container: every assertion passes and the old path 404s. --- .github/workflows/build.yml | 2 +- index.html | 57 ++++++++++++-------------------- public/{og-v1.png => og-v2.png} | Bin tools/README.md | 13 +++++++- tools/og.html | 8 ++--- 5 files changed, 39 insertions(+), 41 deletions(-) rename public/{og-v1.png => og-v2.png} (100%) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 1762d00..7fce9ff 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -72,7 +72,7 @@ jobs: curl -sfI "http://localhost:7000$ASSET" > /dev/null || (echo "bundle $ASSET not served" && exit 1) # public/ has to survive the build into the image: nothing else would # catch the favicons and the social card quietly going missing. - for f in /favicon.ico /favicon.svg /og-v1.png /site.webmanifest; do + for f in /favicon.ico /favicon.svg /og-v2.png /site.webmanifest; do curl -sfI "http://localhost:7000$f" > /dev/null || (echo "static asset $f not served" && exit 1) done docker stop orbital-smoke diff --git a/index.html b/index.html index 8036e2f..afc7584 100644 --- a/index.html +++ b/index.html @@ -4,6 +4,27 @@ + + + + + + + + + + + + + + + + + + + + + Sentry Live @@ -21,41 +42,7 @@ - - - - - - - - - - - - - - - - - - - +
diff --git a/public/og-v1.png b/public/og-v2.png similarity index 100% rename from public/og-v1.png rename to public/og-v2.png diff --git a/tools/README.md b/tools/README.md index 0bdcdda..9b86487 100644 --- a/tools/README.md +++ b/tools/README.md @@ -47,9 +47,20 @@ down rather than swapped for a simpler drawing. `png.mjs` is a dependency-free PNG encoder/decoder plus an `.ico` packer. It exists so this repo can write image files without taking on a dependency. +## A note on the social tags + +`index.html` keeps every `og:` and `twitter:` tag on a single line, in one +contiguous block near the top of ``, with only short comments around them. +That is deliberate. Slackbot reads just the first 32KB of a document, not every +scraper parses HTML properly, and `og:image:alt` is a sub-property of +`og:image` — a tag wrapped across lines, or a stray property interrupting the +image group, is the sort of thing a line-oriented parser drops the image over. +An HTML comment also may not contain a double hyphen, so keep the prose here +rather than in the head. + ## The social card -`og.html` builds `public/og-v1.png`, the 1200×630 card. Start the dev server, +`og.html` builds `public/og-v2.png`, the 1200×630 card. Start the dev server, open , and use the download link. It composites rather than screenshots. The app fits the planet to the viewport, diff --git a/tools/og.html b/tools/og.html index 323b321..166e58e 100644 --- a/tools/og.html +++ b/tools/og.html @@ -4,7 +4,7 @@ Sentry Live — OG builder