From bdc05d40e689a96725bdb724bf3b7aaf2249dd86 Mon Sep 17 00:00:00 2001
From: max furman <mx.furman@gmail.com>
Date: Thu, 21 Feb 2019 15:27:55 -0800
Subject: [PATCH] docs: Streamlined distribution docs

---
 docs/distribution.md | 80 ++++++++++++++++++++++++--------------------
 1 file changed, 44 insertions(+), 36 deletions(-)

diff --git a/docs/distribution.md b/docs/distribution.md
index 0aebc94f..c3ae48e5 100644
--- a/docs/distribution.md
+++ b/docs/distribution.md
@@ -16,59 +16,62 @@ e.g. `v1.0.2`
 `-rc*` suffix. e.g. `v1.0.2-rc` or `v1.0.2-rc.4`
 
 
-1. Find the most recent tag.
+1. **Commit all changes.**
+
+    Make sure that the local checkout is up to date with the remote origin and
+    that all local changes have been pushed.
 
     ```
-    git fetch --tags
-    git tag
+    git pull --rebase origin master
+    git push
     ```
 
-    The new tag needs to be the logical successor of the most recent existing tag.
-    See [versioning](./README.md#versioning) section for more information on version numbers.
+2. **Tag it!**
 
-2. Select the next tag (but don't actually tag anything yet!!).
+    1. **Find the most recent tag.**
 
-    Is the new release a *release candidate* or a *standard release*?
+        ```
+        git fetch --tags
+        git tag
+        ```
 
-    1. Release Candidate
+        The new tag needs to be the logical successor of the most recent existing tag.
+        See [versioning](#versioning) section for more information on version numbers.
 
-        If the most recent tag is a standard release, say `v1.0.2`, then the version
-        of the next release candidate should be `v1.0.3-rc.1`. If the most recent tag
-        is a release candidate, say `v1.0.2-rc.3`, then the version of the next
-        release candidate should be `v1.0.2-rc.4`.
+    2. **Select the next tag (but don't actually tag anything yet!!).**
 
-    2. Standard Release
+        Is the new release a *release candidate* or a *standard release*?
 
-        If the most recent tag is a standard release, say `v1.0.2`, then the version
-        of the next standard release should be `v1.0.3`. If the most recent tag
-        is a release candidate, say `v1.0.2-rc.3`, then the version of the next
-        standard release should be `v1.0.3`.
+        1. Release Candidate
 
-3. Update the remote origin with your commits.
+            If the most recent tag is a standard release, say `v1.0.2`, then the version
+            of the next release candidate should be `v1.0.3-rc.1`. If the most recent tag
+            is a release candidate, say `v1.0.2-rc.3`, then the version of the next
+            release candidate should be `v1.0.2-rc.4`.
 
-    Make sure that the local checkout is up to date with
-    with the remote origin and that all local changes have been pushed.
+        2. Standard Release
 
-    ```
-    git pull --rebase origin master
-    git push
-    ```
+            If the most recent tag is a standard release, say `v1.0.2`, then the version
+            of the next standard release should be `v1.0.3`. If the most recent tag
+            is a release candidate, say `v1.0.2-rc.3`, then the version of the next
+            standard release should be `v1.0.3`.
 
-4. Create a local tag.
 
-    ```
-    git tag v1.0.3   # standard release
-    ...or
-    git tag v1.0.3-rc.1  # release candidate
-    ```
+    3. **Create a local tag.**
 
-5. Push the new tag to the remote origin.
+        ```
+        git tag v1.0.3   # standard release
+        ...or
+        git tag v1.0.3-rc.1  # release candidate
+        ```
 
-    ```
-    git push origin tag v1.0.3   # standard release
-    ...or
-    git push origin tag v1.0.3-rc.1  # release candidate
-    ```
+    4. **Push the new tag to the remote origin.**
+
+        ```
+        git push origin tag v1.0.3   # standard release
+        ...or
+        git push origin tag v1.0.3-rc.1  # release candidate
+        ```
 
 6. Check the build status at
 [Travis-CI](https://travis-ci.com/smallstep/certificates/builds/).
@@ -85,3 +88,8 @@ e.g. `v1.0.2`
     * **step-ca_1.0.3_darwin_amd64.tar.gz**: tarball containing a statically compiled darwin binary.
 
 *All Done!*
+
+## Versioning
+
+We use [SemVer](http://semver.org/) for versioning. For the versions available,
+see the [tags on this repository](https://github.com/smallstep/certificates).