Skip to content

Cut cross-domain _redirects so docs.pccx.ai stays standalone#108

Merged
hkimw merged 1 commit into
mainfrom
chore/cut-cross-domain-redirects-20260527
May 27, 2026
Merged

Cut cross-domain _redirects so docs.pccx.ai stays standalone#108
hkimw merged 1 commit into
mainfrom
chore/cut-cross-domain-redirects-20260527

Conversation

@hkimw

@hkimw hkimw commented May 27, 2026

Copy link
Copy Markdown
Member

Summary

  • Delete _extra/_redirects. It held nine 301 rules that rewrote every docs.pccx.ai page (/, /*, /en/*, /ko/*, /docs/v002/*, /en/docs/v002/*, /ko/docs/v002/*, /robots.txt, /sitemap.xml) to corresponding paths under docs.altifigence.com. With those rules removed, docs.pccx.ai serves its own Sphinx build directly.

Why

docs.pccx.ai is now the v002 legacy archive and is fully separated from docs.altifigence.com (the canonical PCCX hub beyond v002). Forwarding visitors to docs.altifigence.com fights that split, and the redirect cache it produces (301 is permanently cached by browsers) leaves users stuck at account.altifigence.com when they later try to reach https://docs.pccx.ai.

The deploy workflow already guards the redirect-copy step on if [ -f _extra/_redirects ]; then cp ...; fi, so removing the file makes the step a no-op without any other workflow change. The Sphinx build's existing root index.html (<meta http-equiv="refresh" content="0; url=en/index.html">) keeps the site fully self-contained.

Related changes

  • pccxai/pccx-vision-v001 repo deleted 2026-05-27.
  • docs/{v003,vision-v001,Lab} and ko mirrors removed from this Sphinx tree in Drop v003, vision-v001, and Lab from the Sphinx site #107.
  • Altifigence/altifigence-docs#93 landed the one-time Sphinx HTML snapshot at docs.altifigence.com/v002/sphinx-mirror/. The two sites do not sync going forward.

Test plan

  • make strict (CI) builds without warnings.
  • After deploy, curl -sI https://docs.pccx.ai/ returns 302 with Location: /en/ (same domain).
  • curl -sI https://docs.pccx.ai/en/docs/v002/Architecture/rationale.html returns 200 with Sphinx HTML.
  • Browser visit to https://docs.pccx.ai in incognito (no stale 301 cache) lands on the v002 docs, not on account.altifigence.com.

docs.pccx.ai is the v002 legacy site now and should serve its own Sphinx
build instead of forwarding visitors to docs.altifigence.com. The
_extra/_redirects file held nine 301 rules that rewrote every page —
/, /*, /en/*, /ko/*, /docs/v002/*, /en/docs/v002/*, /ko/docs/v002/*,
/robots.txt, /sitemap.xml — to corresponding paths under
docs.altifigence.com.

Drop the file entirely. The deploy.yml \"Create root redirect page\"
step is gated on `if [ -f _extra/_redirects ]`, so it now no-ops, and
the Sphinx build's own root index.html (with its same-domain meta
refresh to /en/) keeps the site fully self-contained.

Companion change: pccxai/pccx-vision-v001 was deleted on 2026-05-27 and
v003 / vision-v001 / Lab were removed from this Sphinx tree in #107.
docs.altifigence.com is now the canonical hub for everything beyond
v002; docs.pccx.ai is a frozen v002 archive.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying pccx with  Cloudflare Pages  Cloudflare Pages

Latest commit: ff94e44
Status: ✅  Deploy successful!
Preview URL: https://cf4f9d38.pccx.pages.dev
Branch Preview URL: https://chore-cut-cross-domain-redir.pccx.pages.dev

View logs

@hkimw hkimw merged commit e42dcc0 into main May 27, 2026
2 checks passed
@hkimw hkimw deleted the chore/cut-cross-domain-redirects-20260527 branch May 27, 2026 05:09
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