cockroachdb / cockroachdb/docs
Need upgrade path doc
- 主要言語
- HTML
- スター
- 212
- フォーク
- 476
- 平均マージ
- 40分
- マージ済み PR(30日)
- 3
説明
Bram Gruneir (BramGruneir) commented:
We're missing a clear and concise doc that's explicit on exactly which versions need to be walked through to upgrade.
Our mixing of major and minor version numbers is already confusing for just about everyone, so lacking this doc makes it worse.
I'm thinking something along the lines of:
```
2.0.x -> 2.1.x
2.1.x -> 19.1.x
19.1.x -> 19.2.x
19.2.x -> 20.1.x
20.1.x -> 20.2.x
```
With some language about:
- what we consider a major version
- how we don't have minor versions
- how patch versions can be applied
- how we must upgrade through each major version
- when can you downgrade (put a previous patch version on)
- how we finalize the version (and downgrades cannot happen afterwards)
- and how to prevent the finalization step if needed, but a warning about not doing so
- maybe a note about our release cadence and numbering because it's confusing.
Jira Issue: DOC-524
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
評価
この issue はまだ評価されていません。