[Meta] Update docs outline
scottrigby opened this issue · 0 comments
scottrigby commented
This issue is to track desired updates to the top-level docs outline, which was covered in today's meeting with @pzfreo @bia @jrryjcksn @scottrigby.
These issues below are all well-formatted & actionable, so that team members can take them on in parallel. This issue will depend on those others for completion.
Outline
Here are maps between the desired and current outlines:
Map: (meeting outline -> to current docs)
- Intro -> introduction
- Start now -> getting started
- Guides -> Examples
- Cli ref -> cli ref
- What’s coming -> add simple language on this to the intro (see far below)
- FAQ -> Need to add
- Follow -> HOLD (can link to Weave GitOps marketing page on WW website when it’s ready)
Map: (current docs -> meeting outline)
- Architecture -> REMOVE for now based on today’s meeting? Concepts are simply added to intro for now
- Troubleshooting -> KEEP as-is. Maybe link to support from there “if you’ve tried all of the above and still have probs, feel free to contact WW support at …”
- Examples -> Guides
- GitOps Automation Configuration -> Getting Started/Configuration (later add to top-level in guides for more advanced configuration, once we have more content for it)