Update notes for releasing.

releasing/README.md

@@ -0,0 +1,87 @@
+# Releasing
+
+[releases page]: https://github.com/kubernetes-sigs/kustomize/releases
+[`cloud-build-local`]: https://github.com/GoogleCloudPlatform/cloud-build-local
+[Google Cloud Build]: https://cloud.google.com/cloud-build
+[semver]: https://semver.org
+
+Scripts and configuration files for publishing a
+`kustomize` release on the [releases page].
+
+## Build a release locally
+
+Install [`cloud-build-local`], then run
+
+```
+./releasing/localbuild.sh
+```
+
+to build artifacts under `./dist`.
+
+## Do a real (cloud) release
+
+Get on an up-to-date master branch:
+```
+git fetch upstream
+git checkout master
+git rebase upstream/master
+```
+
+### review tags
+
+```
+git tag -l
+git ls-remote --tags upstream
+```
+
+### define the new tag
+
+Define the version per [semver] principlesl it must start with `v`:
+
+```
+version=v3.0.0-pre
+```
+
+### delete the tag if you wish to replace it upstream
+
+Local delete:
+
+```
+git tag --delete $version
+```
+
+Upstream delete:
+```
+# Disable push protection:
+git remote set-url --push upstream git@github.com:kubernetes-sigs/kustomize.git
+
+# The empty space before the colon effectively means delete the tag.
+git push upstream :refs/tags/$version
+
+# Enable push protection:
+git remote set-url --push upstream no_push
+```
+
+Optionally visit the [release page] and delete
+(what has now become) the _draft_ release for that
+version.
+
+### tag locally
+
+```
+git tag -a $version -m "Release $version"
+```
+
+### trigger the cloud build
+
+Pushing the tag will trigger a job in [Google Cloud
+Build] to put a new release on the [releases page].
+
+```
+git push upstream $version
+```
+
+###  Update release notes
+
+Visit the [release page] and edit the release notes as desired.
+