Skip to content

docs: retire the GitHub Pages deployment, declare a canonical URL - #114

Merged
puckey merged 2 commits into
mainfrom
docs/retire-github-pages
Aug 11, 2026
Merged

docs: retire the GitHub Pages deployment, declare a canonical URL#114
puckey merged 2 commits into
mainfrom
docs/retire-github-pages

Conversation

@puckey

@puckey puckey commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

audiobrowser.dev is served by Cloudflare Pages now, built from main on every push. Two follow-ups to that.

Retire GitHub Pages

docs.yml was deploying a second, competing build of the same site, and website/CNAME only ever meant anything to that host. Both removed.

The GitHub Pages site is unbound from the repo separately — deleting the workflow stops new deployments but does not release the domain.

Kept: the _github-pages-challenge-radio-garden TXT record. It holds GitHub's org-level verification of audiobrowser.dev, and while it exists no other GitHub account can claim the domain for Pages.

Canonical URL

The project answers on audiobrowser.pages.dev as well as audiobrowser.dev, serving the same build from the same commit — two hostnames with identical content, competing in search results. A canonical URL points both at audiobrowser.dev.

Skipped for DOCS_NOINDEX builds: noindex plus a canonical pointing elsewhere are contradictory signals, and previews are already noindexed.

Verification

Production build:

<link rel="canonical" href="https://audiobrowser.dev/">
<link rel="canonical" href="https://audiobrowser.dev/guide/getting-started">
<link rel="canonical" href="https://audiobrowser.dev/api/">

DOCS_NOINDEX=1 build: zero canonical tags, robots meta present.

yarn ci:format, yarn ci:lint, yarn types pass.

puckey added 2 commits August 11, 2026 21:56
audiobrowser.dev is served by Cloudflare Pages now, built from this branch on
every push. docs.yml was deploying a second, competing build of the same site
to GitHub Pages, and website/CNAME only ever meant anything to that host.

The GitHub Pages site itself is unbound from the repo separately — deleting
the workflow stops new deployments but does not release the domain.

Not removed: the _github-pages-challenge-radio-garden TXT record. It holds
GitHub's org-level verification of audiobrowser.dev, and while it exists no
other GitHub account can claim the domain for Pages.
The Pages project answers on audiobrowser.pages.dev as well as
audiobrowser.dev, serving the same production build from the same commit. Two
hostnames with identical content compete in search results; a canonical URL
points both at audiobrowser.dev.

Skipped for DOCS_NOINDEX builds. A page that is both noindexed and
canonicalised elsewhere sends contradictory signals, and previews are already
noindexed, so there is nothing left to disambiguate.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying audiobrowser with  Cloudflare Pages  Cloudflare Pages

Latest commit: eaea018
Status: ✅  Deploy successful!
Preview URL: https://8b69cf93.audiobrowser.pages.dev
Branch Preview URL: https://docs-retire-github-pages.audiobrowser.pages.dev

View logs

@puckey
puckey merged commit ef6f5f8 into main Aug 11, 2026
4 checks passed
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 0.2.0-next.7 🎉

The release is available on:

Your semantic-release bot 📦🚀

@radio-garden-release

Copy link
Copy Markdown

🎉 This PR is included in version 0.2.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant