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:
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.