cockroachdb / cockroachdb/docs

Need upgrade path doc

Abierto
#7,433 3 comentarios 0 reacciones 1 asignado Reclamado por @taroface Ver en GitHub
C-doc-improvement no-issue-activity P-3 T-missing-info
Lenguaje dominante
HTML
Estrellas
212
Forks
476
Merge medio
40 min
PR fusionados (30 d)
3

Descripción

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

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.