cockroachdb / cockroachdb/docs

Need upgrade path doc

オープン
#7,433 コメント 3 件 リアクション 0 件 担当者 1 名 @taroface が担当を希望しています GitHub で見る
C-doc-improvement no-issue-activity P-3 T-missing-info
主要言語
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 はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。