跳转到内容

20261019-1200-switch-docs-current-state Rewrite the P05 Switch product documents to state the current design only

  • status: completed
  • createdAt: 2026-10-19 12:00
  • approvedAt: 2026-10-19 12:00 (owner chose option 2: "2")
  • relatedTask: 20261019-1200-switch-docs-current-state

About 180 body lines across 17 pages carry change narratives; most are in the Air Hub spec (50), the Air Hub reference-board page (31), the Air and Air Hub design appendices (18 each) and the Air spec (14). The documentation standard requires every controlled page to end with a ## 变更记录 table, so the history stays there and only the body is rewritten.

  1. Air Hub: spec, design appendix, reference-board page, guide, brief, EMC evaluation.
  2. Air: spec, design appendix, guide, brief.
  3. Key and the Switch line: spec, design appendix, guide, brief for each.
  4. One change-log row and a version bump per changed controlled page.
  5. Quality gate; refresh the handover copies in /srv/ybo/switch/handover/.
  • A design appendix explains choices by comparison; rejected options stay as "未采用" with a reason so the rationale is not lost.
  • Cross-references to removed sentences: checked by lint and by searching for anchors.