docs: separate laptop docs from Kubernetes and platform docs
Open
@mrsabath is already working on this.
Since Sep 10, 2026.
documentation
nice to have
- Dominant language
- Go
- Stars
- 13
- Forks
- 40
- Avg merge
- 12h 17m
- Merged PRs (30d)
- 156
Description
Feature Description
A laptop user following the docs currently lands on SPIRE and Keycloak setup, which reads as
though it were required.
Proposed Solution
- Two entry points, clearly labelled by audience
- The laptop path never requires reading a Kubernetes page
- Platform docs stay reachable and unbroken
- Existing links redirected or updated
Additional Context
Part of the Cortex v0.9.0 release, stretch scope.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.