cockroachdb / cockroachdb/docs

Need upgrade path doc

未关闭
#7,433 3 条评论 0 个 reaction 已指派 1 人 已被 @taroface 认领 在 GitHub 查看
C-doc-improvement no-issue-activity P-3 T-missing-info
主要语言
HTML
星标
212
派生
476
平均合并
40 分钟
30 天内合并 PR
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 摘要。