diff --git a/README.md b/README.md
index 5a87a9d12..24f2d553a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# cert-manager [![Build Status](https://travis-ci.org/jetstack/cert-manager.svg?branch=master)](https://travis-ci.org/jetstack/cert-manager)
+# cert-manager
 
 cert-manager is a Kubernetes add-on to automate the management and issuance of
 TLS certificates from various issuing sources.
@@ -38,7 +38,7 @@ support
 
 The easiest way to deploy cert-manager into your cluster is to use the Helm
 chart. For information on how to do this see the [Deploying cert-manager using
-Helm](docs/user-guides/helm.md) user guide.
+Helm](docs/user-guides/deploying.md) user guide.
 
 ### Creating your first Issuer and Certificate
 
diff --git a/docs/README.md b/docs/README.md
index 16d7146d4..8f7183533 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -13,6 +13,7 @@ It is split into these three sections for easier navigation.
 ## User guides
 
 * [Deploying cert-manager using Helm](user-guides/deploying.md)
+* [Migrating from kube-lego](user-guides/migrating-from-kube-lego.md)
 * [ingress-shim configuration and usage](user-guides/ingress-shim.md)
 * [Creating a simple CA based issuer](user-guides/ca-based-issuer.md)
 * [Creating cluster wide issuers](user-guides/cluster-issuers.md)
diff --git a/docs/user-guides/README.md b/docs/user-guides/README.md
index 8fe8dc052..d61309e01 100644
--- a/docs/user-guides/README.md
+++ b/docs/user-guides/README.md
@@ -3,6 +3,7 @@
 This section of the documentation contains user guides for cert-manager. Full specifications of the different options in cert-manager can be found in [`docs/api-types`](../api-types).
 
 * [Deploying cert-manager using Helm](deploying.md)
+* [Migrating from kube-lego](migrating-from-kube-lego.md)
 * [ingress-shim configuration and usage](ingress-shim.md)
 * [Creating a simple CA based issuer](ca-based-issuer.md)
 * [Creating cluster wide issuers](cluster-issuers.md)