docs: customer-facing upgrade guide
@kristinapathak is already working on this.
Since Sep 18, 2026.
- Dominant language
- Go
- Stars
- 218
- Forks
- 72
- Avg merge
- 1d 12h
- Merged PRs (30d)
- 427
Description
There is no upgrade documentation under docs/user/, and docs/user/release-notes/ contains only an index.md.
A customer needs to be able to answer three things without experimenting on their cluster: where am I, where am I going, and what do I run. The rule should be short enough to repeat from memory — install the latest patch of each major version between yours and your target, in order, waiting for migrations between each.
Also needed: "minimum upgrade from" stated at the top of every release note, and a plain statement that you cannot roll back across a destructive migration except by backup and restore.
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.