refactor: remove section dividers
FAQ #14 + Release-Notes See-also + author-attribution dedup
Final consistency pass before screenshot capture. Closes the cross-page
consolidation loop the Phase 4 plan called for and addresses the only
content page that was missing a See-also footer.
- FAQ.md gains entry #14: "Why are my annotations anonymous?" Links out
to Review System -> Author attribution for the design rationale.
- Troubleshooting.md shortens its author-attribution section to a
one-line cross-link into the new FAQ entry, removing the in-line
restatement.
- Release-Notes.md gains a See-also footer.
Consistency sweep results across the wiki:
- All 21 content pages carry the top breadcrumb (Home intentionally
exempt; chrome files _Sidebar / _Footer exempt).
- All content pages now carry a See-also footer.
- Zero stale "Phase N" / "Coming in Phase" / TODO leak-throughs.
- Zero em-dashes / en-dashes / smart quotes.
- Zero broken internal page links.
- All 14 FAQ anchors valid.
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.