servius/sukr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add cross-references and fix nav ordering

Browse Source 
Link feature names in architecture.md to feature docs pages.
Add See Also section to configuration.md with related pages.
Add getting-started prerequisite link to deployment.md. Adjust
page weights for user journey sidebar order: Getting Started
(0) → Deployment (1) → Content Organization (2) → Config (3).
This commit is contained in:
Timothy DeHerrera
2026-02-12 13:27:23 -07:00
parent 44e51cbdb7
commit ef173ec092
5 changed files with 17 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/plans/documentation-overhaul.md
View File

@@ -88,7 +88,7 @@ None. All CHALLENGE questions resolved.
- [x] Remove inline config reference (link to docs site `configuration.md`)
- [x] Keep security overview (short, relevant for trust evaluation)
- [x] Trim `themes/README.md` to attribution + structure + link to docs site (targeted exception)
- [ ] Add cross-references between docs pages where missing
- [x] Add cross-references between docs pages where missing
## Verification
@@ -104,7 +104,7 @@ None. All CHALLENGE questions resolved.
| Item | Severity | Why Introduced | Follow-Up | Resolved |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------- | :------------------------------------------------------ | :--------------------------------------------------------------- | :------: |
| `deployment.md` and `content-organization.md` both have weight 1 — alphabetical sort puts Content Org before Deployment in sidebar, suboptimal for user journey | Low | Changing other page weights was scope creep for Phase 3 | Adjust weights to match Install → Deploy → Organize user journey | ☐ |
| `deployment.md` and `content-organization.md` both have weight 1 — alphabetical sort puts Content Org before Deployment in sidebar, suboptimal for user journey | Low | Changing other page weights was scope creep for Phase 3 | Adjust weights to match Install → Deploy → Organize user journey | ☑ |
## Retrospective