Update PUBLISHING.md

PUBLISHING.md

@@ -1,13 +1,19 @@
 # Publishing new version
 
-- Update version in `package.json`
+1.) Change the version number in package.json. Run the following command in the package root directory, replacing <update_type> with one of the semantic versioning release types (prerelease, prepatch, preminor, premajor, patch, minor, major):
-- `git tag vx.x.x`
+npm version <update_type> --preid pre --no-git-tag-version
-- `git push --tags`
+
-- `docker buildx build --platform linux/amd64 -t maptiler/tileserver-gl:latest -t maptiler/tileserver-gl:[version] .`
+--preid specifies which suffix to use in the release such as pre, next, beta, rc, etc.
-- `docker push maptiler/tileserver-gl --all-tags`
+
-- `npm publish --access public` or `node publish.js` 
+prepatch, preminor, and premajor start a new series of pre-releases while bumping the patch, minor, or major version. E.g. premajor with --preid pre would do a prerelease for a new major using the -pre suffix (i.e. it would be a new major with -pre.0)
-- `node publish.js --no-publish`
+
-- `cd light`
+You can use prerelease to bump the version for a new pre-release version. E.g. you could run npm version prerelease --preid pre --no-git-tag-version to go from -pre.0 to -pre.1.
-- `docker buildx build --platform linux/amd64 -t maptiler/tileserver-gl-light:latest -t maptiler/tileserver-gl-light:[version] .`
+
-- `docker push maptiler/tileserver-gl-light --all-tags`
+For regular versions, you can use patch, minor, or major. E.g. npm version major --no-git-tag-version.
-- `npm publish --access public`
+
+2.) Update the changelog, which can be found in CHANGELOG.md. The heading must match ## <VERSION> exactly, or it will not be picked up. For example, for version 5.0.0:
+## 5.0.0
+
+3.) Commit and push the changes.
+
+4.) Run the 'Build, Test, Release' github workflow. The workflow will create a NPM, Docker, and Github release and Tag.