Skip to content

History / Protocol

Revisions

  • Rewrite wiki as fully flat page names, no / grouping The earlier Category/Page-Name structure (mimicking GitHub Wiki's sidebar auto-grouping feature) caused real, reproducible routing bugs: GitHub's wiki page index appears to key on basename alone in at least some lookup paths, so English and Chinese pages sharing a basename (Controller-Setup, Protocol, Prerequisites, ...) collided -- one URL would serve the wrong language's content, and some combinations 404'd outright, confirmed against the raw git blobs (always correct) vs the rendered wiki page (sometimes wrong or missing). Every page name is now a single globally-unique flat string (English: Controller-Setup-Prerequisites; Chinese: Chinese-Controller-Setup-Prerequisites), which cannot collide. The custom _Sidebar.md still presents them grouped by category and language, so navigation looks the same as before despite the flatter underlying names.

    @Kevin28576 Kevin28576 committed Aug 31, 2026
  • Rename zh/ prefix to Chinese/ throughout GitHub's wiki router 404s on every page under a literal 'zh/' path prefix, dropping the last path segment and redirecting to a non-existent parent page instead of serving the actual page (raw git content is fine via raw.githubusercontent.com, just the wiki UI routing itself refuses it). Suspected reserved-word collision (zh as a language code). Renaming the prefix sidesteps it entirely rather than depending on understanding GitHub's routing internals.

    @Kevin28576 Kevin28576 committed Aug 31, 2026
  • Mirror docs/ into the wiki, English + Traditional Chinese Converts all 32 pages from docs/ (controller-setup/, protocol/, both language trees) into wiki pages, grouped the same way (Controller-Setup/*, Protocol/*, zh/ prefix for the Chinese tree). Internal .md links are rewritten to wiki-style page links (anchors preserved); links to things outside docs/ (the top-level READMEs, driver/README.md) become absolute GitHub URLs; the one image reference points at the repo's raw.githubusercontent.com URL instead of a relative path. Home.md and zh/Home.md are hand-adjusted versions of docs/README.md and docs/zh/README.md (wiki-appropriate wording, not a straight mechanical conversion). Adds a custom _Sidebar.md mirroring the same categorization in both languages. docs/ in the repository remains the source of truth if the two ever drift.

    @Kevin28576 Kevin28576 committed Aug 31, 2026