refactor: remove section dividers
Update Solarxy v0.6.0 wiki docs
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.
Write Quickstart and four tutorial pages
Fill the Phase 1 scaffolds with full prose. Each page uses the hybrid
format: short scenario opening, numbered steps with inline screenshot
TODOs, then Verify / What you learned / Where to go next.
Quickstart (~170 lines):
- Five-minute path from install to first saved review marker.
- Khronos DamagedHelmet.glb as the working asset.
Tutorial: First review session (~225 lines):
- Reviewer-side narrative through the full anchor-stability loop.
- FlightHelmet recommended for multi-mesh re-anchor practice; falls back
to DamagedHelmet for single-file simplicity.
- Walks the click ladder, the four categories, threading, sidecar save,
re-export, Needs re-anchor, manual Re-place.
Tutorial: Inspect a glTF for delivery (~200 lines):
- Artist-side QA narrative. Cycles every inspection mode (1-7), the
wireframe overlay with all three weights, Outliner mesh isolation,
Analyze TUI.
Tutorial: Validate in CI (~210 lines):
- Pipeline-engineer narrative from local solarxy.toml to GitHub Actions
PR annotations to SARIF Code Scanning.
Tutorial: Build a custom validation policy (~210 lines):
- TD narrative for authoring solarxy.toml from scratch on a
representative asset folder. [budgets], [[filenames.rules]],
[validation], [thresholds], iteration loop.
DCC tool guidance stays tool-agnostic throughout. All sample assets
reference the Khronos glTF Sample Assets repo. Plain ASCII punctuation.
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.