Upgrade guides
One page per major version step, with what you must change.
A guide compares the newest release of one major version with the newest release of the next, such as /npm/eslint/upgrade/8-to-9. For packages still on 0.x, guides step through minor versions, such as 0.12-to-0.13.
Each guide shows the verdict, What you must change, Deprecations to plan for, API changes and a migration checklist, with links to the guides before and after it. Open one from the package page's Upgrade guides, or from New majors.