Drop v003, vision-v001, and Lab from the Sphinx site - #107
Merged
Conversation
docs.altifigence.com is now the canonical hub for every PCCX track
beyond v002. This Sphinx site stays as a v002 legacy archive and stops
duplicating v003 / vision-v001 / Lab content that is being maintained
elsewhere.
- Remove docs/{v003,vision-v001,Lab} and their ko/docs/ mirrors (58
files in total, ~6.3k deletions).
- Trim docs/index.rst and ko/docs/index.rst: drop the hidden toctree
entries for v003/index and vision-v001/index, replace the v003 and
vision-v001 grid cards with a single docs.altifigence.com card, and
fold the "Working tracks" bullets into a one-line redirect notice.
- Rewrite docs/quickstart.md, ko/docs/quickstart.md, docs/roadmap.md,
ko/docs/roadmap.md so the surviving Lab and v003/vision pointers
resolve to docs.altifigence.com instead of broken {doc} refs.
- Replace the docs/Evidence/index.rst and ko/docs/Evidence/index.rst
references to ../Lab/cli with a plain-text note pointing at
docs.altifigence.com.
`pccxai/pccx-vision-v001` repo is also removed (deleted 2026-05-27); the
absorption plan continues at docs.altifigence.com inside the v003 track.
v003 / vision / Lab source content lives in git history if anything
needs to be revived later.
Deploying pccx with
|
| Latest commit: |
3169b17
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://bde2316a.pccx.pages.dev |
| Branch Preview URL: | https://chore-drop-v003-vision-lab-f.pccx.pages.dev |
The previous PR moved docs/Lab/ out of this Sphinx tree but missed the toctree section in ko/index.rst that still pointed at docs/Lab/index, which triggered the only sphinx -W warning on the strict EN+KO build. EN index.rst already had no Lab toctree section.
4 tasks
hkimw
added a commit
that referenced
this pull request
May 27, 2026
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.
hkimw
added a commit
that referenced
this pull request
May 30, 2026
… v003 later roadmap (#109) * Cut cross-domain _redirects so docs.pccx.ai stays standalone 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. * docs: retarget v003/tools sidebar + prune roadmap later-v003; en-ko sync - _static/pccx_versions.json: v003 entry now points to https://docs.altifigence.com/v003/ - index.rst, ko/index.rst: dropped Toolchain Demos toctree block; Tools now uses /lab/, /launcher/, /ide/ on altifigence (labels kept English for parity) - docs/roadmap.md + ko/docs/roadmap.md: removed "## Later — v003.x" section and updated family tree caption - docs/samples/index.md + ko/docs/samples/index.md: added :orphan: so removal does not break strict build - conf_common.py, _templates/sidebar/brand.html: updated footer icons - docs/index.rst, README.md, docs/v002/gemma3n-e4b-integration.rst: refreshed stale tool URLs for link health - all changes maintain EN/KO structural parity per repo rules * docs: open v003 + Tools links in new tabs; correct orphan metadata for samples pages - _static/pccx-version-switcher.js: v003 entry and all external sidebar links (Tools) now use target=_blank + rel=noopener (via buildEntry + upgradeExternalSidebarLinks) - docs/samples/index.md + ko/docs/samples/index.md: use proper "orphan: true" YAML frontmatter so removal of Toolchain Demos toctree does not trigger "document isn't included" or transition errors under strict -W -n build - All changes maintain EN/KO parity
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/{v003,vision-v001,Lab}and theirko/docs/mirrors (58 files, ~6.3k deletions).docs/index.rstand the Korean mirror with a singledocs.altifigence.comcard; remove the hidden toctree entries that pointed at the deleted indices.docs/quickstart.md,ko/docs/quickstart.md,docs/roadmap.md,ko/docs/roadmap.md,docs/Evidence/index.rst, andko/docs/Evidence/index.rstso the surviving Lab and v003 / vision pointers resolve todocs.altifigence.cominstead of broken{doc}/:doc:refs.Why
docs.altifigence.comis now the canonical hub for every PCCX™ track beyond v002. This Sphinx site (which deploys todocs.pccx.ai) is being kept as a v002 legacy archive, so it should stop duplicating v003 / vision-v001 / Lab content that lives elsewhere and is being actively maintained.Companion change:
pccxai/pccx-vision-v001was deleted on 2026-05-27 (placeholder repo, no committed RTL, all docs were pointers to the central hub).What stays
docs/v002/and its sub-tracks remain the heart of the site.docs/{Devices,Evidence,archive,commercial,compat,evidence,investor,ip,legal,onboarding,overview,reference,releases,roadmap,samples,stylesheets}) are untouched.conf_common.pyLab / Launcher / IDE footer labels and exclude-pattern entries stay because they are inert text, not broken references.Test plan
make strict(CI) builds with no broken{doc}/:doc:refs.docs.pccx.aiv002 pages still render anddocs.pccx.ai/docs/v003/anddocs.pccx.ai/docs/Lab/404 as expected.docs.altifigence.comretains v003 / vision / Lab content (no impact on the altifigence-docs side from this PR).Recoverability
v003 / vision-v001 / Lab content remains in git history (
git show <pre-merge-sha>:docs/v003/...) if any specific page needs to be revived in the altifigence-docs tree later.