Mismatch in documentation and in release notes

[meaz]

Description

In https://github.com/cryptpad/cryptpad/releases/tag/2024.3.0, it is written that upgrading is done by:

npm ci
npm run install:components

And in https://docs.cryptpad.org/en/admin_guide/maintenance.html#upgrading-cryptpad, it is written that upgrading is done by:

npm update
npm run install:components

Which one is right?

When I try with npm ci I get npm ci can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync. Please update your lock file with npm install before continuing. I don't have that error when using npm update

Steps to reproduce

Run npm update

Relevant logs

`npm ci can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync. Please update your lock file with npm install before continuing.`

Expected behavior

npm ci should just work or the documentation should be updated.

Which operating system are you using?

Linux/BSD/UNIX

What browsers are you seeing the problem on?

Mozilla Firefox

Extensions

None

Version

2024.3.0

[mathilde-cryptpad]

Hello,

Due to an error merging a branch with a dependencies fix just before the release, we messed up our package-lock.json. It was released not in sync with package.json anymore.

To fix this we have updated the upgrade notes in the release changelog. Simply running npm install, instead of npm ci, will fix the issue. Of course, the root cause of the problem will be fixed in a coming release.

[meaz]

Thanks @mathilde-cryptpad though I still have that answer if the "normal" way to update is npm ci or npm update.

[mathilde-cryptpad]

@meaz there is no "normal" way, it depends on each release. Our next release of the documentation will explicitly refer to the GitHub release upgrade instructions: cryptpad/documentation@699715a