Update upgrading docs

Signed-off-by: James Munnelly <james@munnelly.eu>

docs/admin/upgrading/index.rst

@@ -23,7 +23,11 @@ name of your Helm release for cert-manager (usually this is ``cert-manager``):
 .. code:: shell
 
    $ helm repo update
-   $ helm upgrade <release_name> stable/cert-manager
+
+   $ kubectl apply \
+        -f https://raw.githubusercontent.com/jetstack/cert-manager/${VERSION}/deploy/manifests/00-crds.yaml
+
+   $ helm upgrade --version ${VERSION} <release_name> stable/cert-manager
 
 This will upgrade you to the latest version of cert-manager, as listed in the
 `official Helm charts repository`_.
@@ -42,19 +46,16 @@ can upgrade them in a similar way to how you first installed them.
    for your from and to version.
 
 Once you have read the relevant notes and taken any appropriate actions, you
-can begin the upgrade process like so - replacing ``<version_number>`` and
-``<namespace>`` with the version number you want to install, and the namespace
-that cert-manager is deployed into respectively:
+can begin the upgrade process like so - replacing ``${VERSION}`` with the
+version number you want to install:
 
 .. code:: shell
 
-   $ kubectl apply --namespace <namespace> -f \
-       https://github.com/jetstack/cert-manager/blob/<version_number>/contrib/manifests/cert-manager/with-rbac.yaml
+   $ kubectl apply \
+        -f https://raw.githubusercontent.com/jetstack/cert-manager/${VERSION}/deploy/manifests/00-crds.yaml
 
-.. note::
-   Please be sure to choose the correct variant of the static manifests, i.e.
-   one of the ``with-rbac`` or ``without-rbac`` files, depending on your cluster
-   configuration.
+   $ kubectl apply \
+        -f https://raw.githubusercontent.com/jetstack/cert-manager/${VERSION}/deploy/manifests/cert-manager.yaml
 
 .. toctree::
    :maxdepth: 1
@@ -62,6 +63,7 @@ that cert-manager is deployed into respectively:
    upgrading-0.2-0.3
    upgrading-0.3-0.4
    upgrading-0.4-0.5
+   upgrading-0.5-0.6
 
 .. _`official Helm charts repository`: https://github.com/helm/charts
 .. _`static deployment manifests`: https://github.com/jetstack/cert-manager/blob/master/contrib/manifests/cert-manager

docs/admin/upgrading/upgrading-0.5-0.6.rst

@@ -0,0 +1,9 @@
+===========================
+Upgrading from v0.5 to v0.6
+===========================
+
+.. todo::
+   Describe additional ``kubectl apply`` step
+
+.. todo::
+   Adding additional notes about upgrading from v0.4