Skip to content
This repository has been archived by the owner on May 7, 2023. It is now read-only.

Deprecate versions

Jump to bottom
esdmr edited this page Nov 4, 2021 · 2 revisions

How to deprecate old major versions

Note: This page is for major versions which have release branches. Follow the npm deprecate documentation page if otherwise.

Note: In this page, OLD_MAJOR is the unsupported major version you intend to deprecate.

It is recommended to support the last two or three major versions, this means that bug fixes and security updates can be backported via release branches.

If you do not plan to support a previous release, you must delete its branch. This will cause the related documentation to be pruned on the next CI run.

  1. Remove the branch locally: git branch -d releases/OLD_MAJOR.
  2. Remove the branch on the remote: git push --delete releases/OLD_MAJOR.

To deprecate a major version in npm, run: pnpm deprecate PACKAGE@OLD_MAJOR "No longer supported", where PACKAGE is the package name in package.json.

Clone this wiki locally