[feature]: docs: add a table showing allowable upgrade paths #10230
Description
We strive to maintain upgrade compatibility for LND databases with previous versions. I think we try to guarantee the last 2 versions. This is not always the case though, sometimes we can only upgrade from the previous version. Sometimes we can upgrade from older than 2 versions.
It would be nice to see a table like this (an example, incomplete and needs to be checked for accuracy) where the rows represent the current version and the columns represent the column upgrading to. If we can directly upgrade from one version to the other, indicate that with an X, if not, leave the cell empty. If we also want to include the ability to downgrade, we could also include that too, but if we only consider upgrading this table will be a lower triangular only.
| LND Version | v0.19.3-beta | v0.19.2-beta | v0.19.1-beta | v0.18.5-beta | v0.18.4-beta | v0.18.3-beta | v0.18.3-beta | v0.18.3-beta | v0.18.2-beta | v0.18.2-beta | v0.18.1-beta | v0.18.0-beta | v0.17.5-beta | v0.17.4-beta | v0.17.4-beta | v0.17.3-beta | v0.17.1-beta | v0.17.0-beta | v0.17.0-beta | v0.16.4-beta | v0.16.4-beta | v0.16.4-beta | v0.16.3-beta | v0.16.2-beta | v0.16.2-beta | v0.16.1-beta | v0.16.0-beta | v0.15.5-beta | v0.15.5-beta | v0.15.5-beta | v0.15.4-beta | v0.15.3-beta | v0.15.2-beta | v0.15.1-beta | v0.15.0-beta | v0.15.0-beta | v0.14.3-beta | v0.14.3-beta | v0.14.2-beta | v0.14.2-beta | v0.14.2-beta | v0.14.1-beta | v0.14.1-beta | v0.13.3-beta | v0.13.3-beta | v0.13.0-beta | v0.13.0-beta | v0.12.1-beta | v0.12.0-beta | v0.11.1-beta | v0.11.1-beta | v0.11.1-beta | v0.11.1-beta | v0.11.1-beta | v0.11.1-beta | v0.11.0-beta | v0.10.3-beta |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| v0.19.3-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.19.2-beta | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.19.1-beta | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.5-beta | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.4-beta | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.3-beta | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.3-beta | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.3-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.2-beta | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.2-beta | X | X | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.1-beta | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||||
| v0.18.0-beta | X | X | X | X | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||
| v0.17.5-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||||
| v0.17.4-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||
| v0.17.4-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||||
| v0.17.3-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||
| v0.17.1-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.17.0-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||
| v0.17.0-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||
| v0.16.4-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.4-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.4-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.3-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.2-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.2-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.1-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.16.0-beta | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | X | ||||||||||||||||||||||||||||||||||||||||
| v0.15.5-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.5-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.5-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.4-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.3-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.2-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.1-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.0-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.15.0-beta | X | X | X | X | X | X | X | X | |||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.3-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.3-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.2-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.2-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.2-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.14.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.13.3-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.13.3-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.13.0-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.13.0-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.12.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.12.0-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.1-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.11.0-beta | X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| v0.10.3-beta | X |