mathjs/misc/how_to_publish.md
2021-05-16 14:01:32 +02:00

1.6 KiB

How to publish math.js

This document describes the steps required to publish a new version of math.js.

Update version number

Update the version number package.json.

Run npm install to also have this version number updated in package-lock.json

Update history

Update the date and version number in the file HISTORY.md. Verify whether all changes in the new version are described.

Update authors

Run:

npm run update-authors

Build and test

Build the distribution files in folders under lib, and test everything by running:

npm run build-and-test

After the build is complete, verify whether the files are created and contain the correct date and version number in the header.

Commit

  • Commit the final code.
  • Merge the develop branch into the master branch.
  • Push to github.

Now go to Github Actions and verify if the tests run fine there as well:

https://github.com/josdejong/mathjs/actions

If everything is well, create a tag for the new version, like:

git tag v1.2.4
git push --tags

Publish

Publish to npm:

npm publish

Test published libraries

Install the libraries locally and test whether they work correctly:

cd tmp-folder
npm install mathjs

Update the website

Wait until the new version of math.js is available on cdnjs.org.

The website is located in the gh-pages branch of the project. Follow the readme in the gh-pages branch on how to update the website.

Update the REST API

Update the mathjs-rest project (served at https://api.mathjs.org).

Back to develop

Switch to the develop branch

Done

Time to drink a beer.