Skip to content

README: load the docs badge from app.readthedocs.org - #421

Merged
thirtytwobits merged 1 commit into
mainfrom
readme-docs-badge
Oct 25, 2026
Merged

thirtytwobits merged 1 commit into
mainfrom
readme-docs-badge

Conversation

@thirtytwobits

Copy link
Copy Markdown
Member

The "Documentation Status" badge in the README shows up as a broken image on GitHub. Its URL, https://readthedocs.org/projects/nunavut/badge/?version=latest, now redirects with a 307 to app.readthedocs.org. This PR points the image straight at:

https://app.readthedocs.org/projects/nunavut/badge/?version=latest

That URL returns image/svg+xml directly. The badge's link target (nunavut.readthedocs.io) is unchanged.

The PyPI version and Python-versions badges were showing stale values only because shields.io caches them for up to 6 hours, so they need no change.

🤖 Generated with Claude Code

The old readthedocs.org badge URL now redirects with a 307 to
app.readthedocs.org, and the badge shows up broken on GitHub. Point the
image at the new host directly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@thirtytwobits
thirtytwobits merged commit 2d2efc3 into main Oct 25, 2026
65 checks passed
@thirtytwobits
thirtytwobits deleted the readme-docs-badge branch October 25, 2026 20:28
thirtytwobits added a commit that referenced this pull request Oct 26, 2026
The "Documentation Status" badge still shows as a broken image on GitHub
after #421, but it works everywhere else.

**Cause:** GitHub loads README images through its camo proxy. For the
Read the Docs badge URL, camo returns `502 Invalid upstream response
(429)`. Read the Docs is rate-limiting the proxy, and this failed 5
times out of 5. Fetched directly, the same URL returns the SVG. Read the
Docs also sends `cache-control: no-store` on the badge, so camo can't
cache it and has to fetch it again for every view.

**Fix:** use the shields.io Read the Docs badge,
`https://img.shields.io/readthedocs/nunavut/latest.svg`, which matches
the README's other shields.io badges. The badge's link target
(`nunavut.readthedocs.io`) is unchanged.

**Checked:** I rendered this branch's README through the GitHub API and
fetched the badge's camo URL three times. Each fetch returned `200
image/svg+xml`, showing "docs: passing".

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
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