Skip to content

docs: repoint two links that 404 - #166

Merged
lesnik512 merged 1 commit into
mainfrom
fix/dead-doc-links
Sep 6, 2026
Merged

docs: repoint two links that 404#166
lesnik512 merged 1 commit into
mainfrom
fix/dead-doc-links

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Why

Three links in published surfaces are dead:

Link Where Status
faststream.airt.ai README.md first paragraph, docs/index.md first paragraph 404
modern-di.readthedocs.io docs/usage/messaging-service.md 404

FastStream moved off airt.ai. faststream.ag2.ai is live and is already what
modern-di-faststream's README uses. The modern-di link should be
modern-di.modern-python.org — the canonical per-project docs URL under the org's
AGENTS.md naming rule.

These sit in the opening sentence of the README and of the docs home page, so they are
about as visible as a broken link gets here.

Design

Three one-line replacements. No prose changes.

Non-goals

Not auditing other external links — the weekly check in modern-python/.github covers
that, and these three are all it currently reports for this repo.

Verification

  • Both replacement URLs return 200; both old hosts return 404.
  • No occurrence of either dead host remains in the tree.
  • lychee --offline still 202 OK / 0 errors, and just docs-build passes.

Worth noting how these were found: the scheduled external check caught them, and the PR
gate structurally could not — no diff in this repo ever touched those lines. That is the
split #65 was arguing for, demonstrated.

FastStream moved off airt.ai; faststream.ag2.ai is the live site and is what
modern-di-faststream's README already uses. The dead link is in the first paragraph
of our README and of the docs home page — the two most-read surfaces in the repo.

The modern-di link pointed at readthedocs, which also 404s. The canonical per-project
docs URL is <name>.modern-python.org, per the org AGENTS.md.

Both replacements verified 200; both old hosts verified 404.

Found by the external link check in modern-python/.github, which is exactly the rot a
scheduled run catches and a PR gate cannot: no diff here ever touched these lines.
@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown

Benchmark gate

✅ gate passed

scenario msg/s delete/msg WALrec/msg WALB/msg fpi upd del dead_tup
consumer/w1/b10 984 1.000 6.79 916 242 5000 5000 10000
consumer/w1/b100 1001 1.000 6.82 920 243 5000 5000 10000
consumer/w2/b10 1173 1.000 6.77 944 242 5000 5000 10000
consumer/w2/b100 1360 1.000 6.72 955 243 5000 5000 10000
consumer/w4/b10 1043 1.000 6.82 995 261 5000 5000 10000
consumer/w4/b100 1547 1.000 6.86 1038 244 5000 5000 10000
consumer/w1/b100/tfbs100 5435 0.010 6.07 1116 243 5000 5000 10000
producer/w1/b100 2057 0.000 3.04 584 0 0 0 0

Gated (fails the build): delete_calls + tuple counters (upd/del/ins) + the producer's insert_calls, exact; select_calls within +2; wal_records within a 10% band. msg/s, WAL bytes and total calls are informational (timing/FPI noise).

@lesnik512
lesnik512 merged commit 2811b0a into main Sep 6, 2026
9 checks passed
@lesnik512
lesnik512 deleted the fix/dead-doc-links branch September 6, 2026 16:31
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.

1 participant