Skip to content

docs: build source-aligned PTO specification portal - #165

Merged
zhoubot merged 5 commits into
mainfrom
codex/site-human-reading
Aug 27, 2026
Merged

docs: build source-aligned PTO specification portal#165
zhoubot merged 5 commits into
mainfrom
codex/site-human-reading

Conversation

@zhoubot

@zhoubot zhoubot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • migrate all 634 released mnemonic routes across 850 ASL units to one Arm-style, source-aligned workbench
  • add canonical instruction and NDF indexes, persistent locale-aware navigation, URL-driven instruction facets, and complete NDF detail relationships
  • derive high-level Tile assembly from structured ASL-owned bundle metadata and fail closed on prose-shaped B.DIM forms
  • embed exact ASL, NDF, ADR/Decision, and AVS content with source identities, accessible semantic IDs, and progressive disclosure
  • reconcile the portal with PR Define CELL rearrangement vector operations #161: 107 current Tile owners, singleton complete-parent Shared semantics, retired owners removed, and ADR-0103 bound to the squash landing parent

Architecture boundary

The portal remains a generated view over owning ASL/NDF sources. The four TCONCAT/TEXTRACT/TINSERT/TMOV ASL edits only normalize B.DIM metadata from prose into explicit optional LB1/LB2 entries; they do not change instruction semantics. The ADR-0103 edit repairs the baseline identity invalidated by PR #161 squash landing. Generated documentation and commit-scoped evidence are refreshed from those owners.

Local evidence

  • make pr-check
  • make repo-check
  • make site-check
  • make site-e2e: 52 passed, 2 skipped
  • make site-quality: desktop performance 100, mobile performance 97, accessibility 99-100, best practices 96, SEO 100, CLS 0
  • Docusaurus English and zh-CN build
  • site artifact: 850 bilingual unit routes, 634 bilingual instruction rows, 0 unexplained omissions
  • git diff --check

Scope exclusions

This PR does not publish the site, run release preparation, create a tag or GitHub Release, deploy Pages, or merge itself.

@zhoubot
zhoubot force-pushed the codex/site-human-reading branch from dd031ea to d74a265 Compare August 27, 2026 11:27
@zhoubot zhoubot changed the title docs: migrate instruction portal to source-aligned pages docs: build source-aligned PTO specification portal Aug 27, 2026
@zhoubot
zhoubot merged commit 0d32703 into main Aug 27, 2026
4 checks passed
@zhoubot
zhoubot deleted the codex/site-human-reading branch August 27, 2026 12:34
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