From 55c8c18b6f0e988bf95e1b5c91fa0de8cc1d1cf1 Mon Sep 17 00:00:00 2001 From: Richard Quinn Date: Sat, 29 Aug 2026 12:51:33 +0200 Subject: [PATCH] docs: the demo link pointed at a host that no longer resolves (#696) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `disarm-web.pages.dev` fails at DNS, so the "Try disarm in your browser" link was a hard error rather than a redirect a browser would follow. The demo now lives at https://disarm.dev/tools/. The link appeared twice, on the two pages most readers see first: README.md, which is the crates.io and PyPI landing copy, and docs/index.md, the docs.disarm.dev homepage. On both it is the first call to action under `## Demo`, above the whole "Why disarm" case. `mkdocs build --strict` validates internal links, not external hosts, and no other job checks them — which is how this survived in those two files. Signed-off-by: Richard Quinn Assisted-by: Claude:claude-opus-5 --- CHANGELOG.md | 13 +++++++++++++ README.md | 2 +- docs/index.md | 2 +- 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 042c870..80b7b63 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,19 @@ compatibility (see [RELEASING.md](RELEASING.md)). ### Fixed +- **The "Try disarm in your browser" link pointed at a host that no longer resolves (#696).** + The demo moved to `https://disarm.dev/tools/` and the link did not follow it. + + `disarm-web.pages.dev` fails at DNS, so this was a hard error rather than a redirect a + browser would follow. It sat on the two most-read pages in the project — `README.md`, + which is the crates.io and PyPI landing copy, and `docs/index.md`, the docs.disarm.dev + homepage — as the first call to action under `## Demo`, above the whole "Why disarm" + case. A reader evaluating the library clicked it before reading anything else. + + `mkdocs build --strict` cannot catch this. It validates internal links, not external + hosts, and no other job checks them either, which is how a dead link survived in the + two files most readers see first. + - **The build banner sat above every page, named a stale version, and nothing linked the canonical site (#692).** Three problems with one footprint. diff --git a/README.md b/README.md index b4bae73..768c195 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ Unicode canonicalization and TR39 *visual* confusable analysis — building bloc ## Demo -**[Try disarm in your browser](https://disarm-web.pages.dev/)** +**[Try disarm in your browser](https://disarm.dev/tools/)** ## Why disarm diff --git a/docs/index.md b/docs/index.md index d3ff07d..5a63aa6 100644 --- a/docs/index.md +++ b/docs/index.md @@ -13,7 +13,7 @@ Unicode canonicalization and TR39 *visual* confusable analysis — building bloc ## Demo -**[Try disarm in your browser](https://disarm-web.pages.dev/)** +**[Try disarm in your browser](https://disarm.dev/tools/)** ## Why disarm