Skip to content

Releasing

Important!

Note: The following checklist is for committers only!

For people who want to contribute a pull request, this isn't relevant!

Branch

All new work should be done in the dev branch.

To begin a new version:

[_] Run the script ./start-version.sh ${version}.

[_] Check in the changed files.

To release a new version, this checklist should be followed:

[_] Get all commits since the last release with git log > temp.txt.

[_] Add a section to the top of the release notes.

[_] Be sure the read me file is up to date, along with all the files in docs.

[_] Create a docker instance with ./docker-start.sh.

[_] Minify the various library versions with npm run build.

[_] Update all personal projects to see if anything breaks.

[_] Check the minified versions and other changed files in.

[_] Merge the dev branch into main.

[_] Push the merge to github with git push.

[_] Update npm with npm publish or npm publish --tag beta. To do this in docker:

bash
docker run -v $(pwd):/srv/app -it abcjs /bin/bash
npm login

[_] Push the change that npm publish created with git push.

[_] On github, "Draft a new release".

  • Click "releases".
  • Click "draft a new release"
  • The tag should be the release number (i.e. "3.0.0")
  • The title should be "Version 3.0.0 release"
  • The description should be a couple sentences about what the release is.

[_] Read through all the issues to see if any should be closed.

[_] Build docs in the docs project with npm run build. Remember to update the abcjs version in package.json first!

[_] Log in to Netlify in the browser and go to the deploy page. Drag the /dist folder onto it to deploy new docs.

[_] If the examples change, go to the Examples Project and follow the instructions in the readme. The /dist folder also needs to be dragged to the Netlify page.

[_] Update https://abcjs.net.

[_] Release a new version of the vscode extension.