refactor: remove section dividers
Add 10 Mermaid diagrams across the wiki
Ten unique Mermaid flowcharts placed at 14 locations across 11 pages,
all using the Ayu Mirage Dark palette matched to the app. Mermaid
renders natively in GitHub wiki pages; no rendering pipeline.
Diagrams:
- Render pipeline (10 stages, MSAA boundary) -> Architecture, Inspection.
- Validation dispatch (merged: 9 checks, order + severity + toggles)
-> Validation-Reference, Tutorial-Custom-Validation-Policy.
- Stale anchor lifecycle -> Review-System,
Tutorial-First-Review-Session.
- Inspection mode decision tree -> Tutorial-Inspect-A-Gltf.
- solarxy-cli dispatch (view/analyze, with/without --paths) ->
Tutorial-Validate-In-CI.
- Dock layout state (default / last / saved transitions) -> Interface,
Architecture.
- Review-mode click ladder (3-rung priority chain) -> Review-System.
- Config discovery (4-step priority ladder) -> Configuration.
- CI adapter and format selection -> CI-CD-Integration.
- 7-crate dependency DAG -> Architecture (replaces the ASCII version).
Each diagram lands at the start of its most-relevant section, before
the prose, with a one-line italic caption underneath. Density is
medium: decision branches and edge labels included; no over-detailed
note blocks.
The plan's separate Diagrams #2 and #9 were merged into one validation
flow per the locked decision. Phase 3 placeholder markers
("Phase 3: Mermaid Diagram N ...") cleaned up from Architecture.
Fill Validation Reference, Architecture, and FAQ
Validation-Reference (~340 lines):
- Worked example for the triangle-budget tolerance band, grounded in
the default 20% formula.
- In-viewport overlay section names the six colour categories sourced
from solarxy-renderer/src/validation.rs: red Error, orange
InvalidMaterial, cyan NormalMismatch, magenta MissingUvs, yellow
DegenerateTriangles, orange-red NonManifoldEdge (edges only, 60%
alpha vs 40% for faces). Notes that triangle_budget has Model scope
and does not paint.
- Analyze TUI Validation-tab keys table.
- Per-check reference: nine H3 subsections (one per check), each with
the five-block template - What it flags / Severity + Toggle / Common
causes / How to fix / Overlay appearance. Fix guidance stays
DCC-agnostic.
Architecture (~190 lines):
- Lean contributor on-ramp: crate map, dependency DAG (ASCII; Mermaid
in Phase 3), the ten-stage render pipeline, State / GuiSnapshot
orientation, dock layout persistence, validation library boundary,
where-to-look table.
- Every file path links to GitHub source at the v0.6.0 tag for
clickable navigation; updates per release.
- Links to in-repo CLAUDE.md for the deeper code-side patterns rather
than reproducing them in the wiki.
FAQ (~180 lines):
- 13 entries ordered by guessed frequency (hottest first): --paths +
--mode analyze, markers disappeared after re-export, which
solarxy.toml was used, shading vs inspection, Shift+S retirement,
amber Review dot, in-app shortcuts, theme hot-swap, texel density
red, markers in UV pane, F4 Quad and UV Map, no CLI MSI on Windows,
no Linux aarch64 AppImage in v0.6.0.
- Each answer: one short paragraph + deep link. Anchor ids kept from
the Phase 1 scaffold so cross-page links stay stable.
Restructure wiki: split User-Guide and Configuration, scaffold new pages
Phase 1 of the comprehensive v0.6.0 milestone wiki plan. Pure restructure -
no new prose - to land the 21-page layout. Phase 2 fills the scaffolded
sections.
New pages (10):
- Quickstart, Tutorial-First-Review-Session, Tutorial-Inspect-A-Gltf,
Tutorial-Validate-In-CI, Tutorial-Custom-Validation-Policy: scaffolds
with TOCs and Phase 2 placeholders.
- Interface, Inspection: split out of User-Guide. Interface holds the
menu bar / pane toolbars / sidebar / dock / status bar / viewport
layouts / loading / console / preferences. Inspection holds view +
inspection modes, material overrides, Material Inspector, lighting,
post-processing, display overlays, mesh visibility, camera.
- Validation-Reference: split out of Configuration. Holds the nine-check
table and thresholds; Phase 2 fills the deeper per-check and overlay
sections.
- FAQ: ten seed questions with anchored stubs.
- Architecture: section stubs with the crate table and the
where-to-look-for-X map.
Modified pages (3):
- User-Guide: shrunk to a hub overview that points to Interface,
Inspection, and the tutorials. Two binaries and supported file formats
stay.
- Configuration: Validation checks block removed and replaced with a
pointer to Validation-Reference. Discovery, schema, field reference,
and the entire config.toml section are unchanged.
- _Sidebar: rebuilt for the 21-page navigation in six sections.