Doc fixup to reflect script reality

docs/devel/releasing.md

@@ -44,6 +44,7 @@ release breaks down into four pieces:
 
 1. selecting release components;
 1. cutting/branching the release;
+1. building and pushing the binaries; and
 1. publishing binaries and release notes.
 
 You should progress in this strict order.
@@ -77,7 +78,7 @@ No matter what you're cutting, you're going to want to look at
 (see above,) and look at the critical jobs building from that branch.  First
 glance through builds and look for nice solid rows of green builds, and then
 check temporally with the other critical builds to make sure they're solid
-around then as well. Once you find some greens, you can find the Git hash for a
+around then as well. Once you find some greens, you can find the git hash for a
 build by looking at the Full Console Output and searching for `githash=`. You
 should see a line:
 
@@ -106,7 +107,7 @@ Before proceeding to the next step:
 export GITHASH=v1.2.0-alpha.2.164+b44c7d79d6c9bb
 ```
 
-Where `v1.2.0-alpha.2.164+b44c7d79d6c9bb` is the Git hash you decided on. This
+Where `v1.2.0-alpha.2.164+b44c7d79d6c9bb` is the git hash you decided on. This
 will become your release point.
 
 ### Cutting/branching the release
@@ -123,50 +124,46 @@ cd contrib/release
 Figure out what version you're cutting, and
 
 ```console
-export VER=vX.Y.0-alpha.W
+export VER="vX.Y.0-alpha.W"
 ```
 
 then, from `contrib/release`, run
 
 ```console
-cut-alpha.sh "${VER}" "${GITHASH}"
+cut.sh "${VER}" "${GITHASH}"
 ```
 
 This will:
 
-1. clone a temporary copy of the [kubernetes repo](https://github.com/kubernetes/kubernetes);
+1. mark the `vX.Y.0-alpha.W` tag at the given git hash;
-1. mark the `vX.Y.0-alpha.W` tag at the given Git hash;
+1. prompt you to do the remainder of the work, including building the
-1. push the tag to GitHub;
+   appropriate binaries and pushing them to the appropriate places.
-1. build the release binaries at the given Git hash;
-1. publish the binaries to GCS;
-1. prompt you to do the remainder of the work.
 
 #### Cutting an official release (`vX.Y.Z`)
 
 Figure out what version you're cutting, and
 
 ```console
-export VER=vX.Y.Z
+export VER="vX.Y.Z"
 ```
 
 then, from `contrib/release`, run
 
 ```console
-cut-official.sh "${VER}" "${GITHASH}"
+cut.sh "${VER}" "${GITHASH}"
 ```
 
 This will:
 
-1. clone a temporary copy of the [kubernetes repo](https://github.com/kubernetes/kubernetes);
+1. do a series of commits on the branch for `vX.Y.Z`, including versionizing
-1. do a series of commits on the branch, including forking the documentation
+   the documentation and doing the release version commit;
-   and doing the release version commit;
+1. mark the `vX.Y.Z` tag at the release version commit;
-  * TODO(ihmccreery) it's not yet clear what exactly this is going to look like.
+1. do a series of commits on the branch for `vX.Y.(Z+1)-beta` on top of the
-1. mark both the `vX.Y.Z` and `vX.Y.(Z+1)-beta` tags at the given Git hash;
+   previous commits, including versionizing the documentation and doing the
-1. push the tags to GitHub;
+   beta version commit;
-1. build the release binaries at the given Git hash (on the appropriate
+1. mark the `vX.Y.(Z+1)-beta` tag at the release version commit;
-   branch);
+1. prompt you to do the remainder of the work, including building the
-1. publish the binaries to GCS;
+   appropriate binaries and pushing them to the appropriate places.
-1. prompt you to do the remainder of the work.
 
 #### Branching a new release series (`vX.Y`)
 
@@ -177,39 +174,30 @@ on the release team.
 Figure out what series you're cutting, and
 
 ```console
-export VER=vX.Y
+export VER="vX.Y"
 ```
 
 then, from `contrib/release`, run
 
 ```console
-branch-series.sh "${VER}" "${GITHASH}"
+cut.sh "${VER}" "${GITHASH}"
 ```
 
 This will:
 
-1. clone a temporary copy of the [kubernetes repo](https://github.com/kubernetes/kubernetes);
+1. mark the `vX.(Y+1).0-alpha.0` tag at the given git hash on `master`;
-1. mark the `vX.(Y+1).0-alpha.0` tag at the given Git hash on `master`;
+1. fork a new branch `release-X.Y` off of `master` at the given git hash;
-1. fork a new branch `release-X.Y` off of `master` at the Given Git hash;
+1. do a series of commits on the branch for `vX.Y.0-beta`, including versionizing
-1. do a series of commits on the branch, including forking the documentation
+   the documentation and doing the release version commit;
-   and doing the release version commit;
+1. mark the `vX.Y.(Z+1)-beta` tag at the beta version commit;
-  * TODO(ihmccreery) it's not yet clear what exactly this is going to look like.
+1. prompt you to do the remainder of the work, including building the
-1. mark the `vX.Y.0-beta` tag at the appropriate commit on the new `release-X.Y` branch;
+   appropriate binaries and pushing them to the appropriate places.
-1. push the tags to GitHub;
-1. build the release binaries at the appropriate Git hash on the appropriate
-   branches, (for both the new alpha and beta releases);
-1. publish the binaries to GCS;
-1. prompt you to do the remainder of the work.
-
-**TODO(ihmccreery)**: can we fix tags, etc., if you have to shift the release branchpoint?
 
 ### Publishing binaries and release notes
 
 Whichever script you ran above will prompt you to take any remaining steps,
 including publishing binaries and release notes.
 
-**TODO(ihmccreery)**: deal with the `making-release-notes` doc in `docs/devel`.
-
 ## Origin of the Sources
 
 TODO(ihmccreery) update this