diff --git a/documentation/README-longform.md b/documentation/README-longform.md index 5e77913bf..e2fec282c 100644 --- a/documentation/README-longform.md +++ b/documentation/README-longform.md @@ -157,11 +157,19 @@ The learn‑by‑doing use case this bundler was built for. Five steps, trainabl 4. **Embed everywhere.** Press the map's **Share button**: *Share Link* is the map's own page, *Add to Your Website* is the embed code — both carry the full URL of whatever host serves your maps (plus a `utm_source` tag on the generated pages, so every site's traffic is measurable). - Verified places a pasted embed works: team websites and WordPress (Custom HTML block), - Squarespace (Code block — iframes need a Business or Commerce plan), Wix (Add → Embed → HTML - iframe), Google Sites (Insert → Embed → By URL), Notion (`/embed` + the Share Link), and internal - boards with an iframe add-on (e.g. Trello's *Card Frames* Power-Up). Rule of thumb: anywhere that - accepts an HTML snippet or a URL embed, over https. + **WordPress is verified here**: `bun run check:wp-embed` renders the real shortcode against the + real built manifest and asserts it emits the same SRI hash the catalog ships, with a negative + case for a malformed integrity value. It runs in the build, needs no MySQL or Docker, and is the + one embed target this repo can prove on its own. + **Expected to work, not tested by us** — each accepts an HTML snippet or a URL embed over https, + which is all the embed code needs: Squarespace (Code block — iframes need a Business or Commerce + plan), Wix (Add → Embed → HTML iframe), Google Sites (Insert → Embed → By URL), Notion (`/embed` + plus the Share Link), and internal boards with an iframe add-on (e.g. Trello's *Card Frames* + Power-Up). Rule of thumb: anywhere that accepts an HTML snippet or a URL embed, over https. + *(This paragraph said "Verified places a pasted embed works" and listed all seven. Corrected + 2026-09-23: the repo holds an artifact for exactly one of them. The platforms are plausible and + the mechanism is the same everywhere; the word "verified" was the part that overreached, and in a + hand-off doc it reads as "someone tried this" when nobody did.)* 5. **Train the trainer.** Teach each team to use the Share button to embed the map — then teach them to train the *next* team the same way. The movement doesn't hang on one mobilization team: every team that carries the map can multiply it.