Update links and add more documentation on needed tools for managing deps.

Signed-off-by: Evan Anderson <evan.k.anderson@gmail.com>

docs/devel/develop-with-minikube.rst

@@ -35,12 +35,21 @@ Install local development tools
 
 You will need the following tools to build cert-manager:
 
-* `Bazel <https://docs.bazel.build/versions/master/install.html>`
+* Go_ (You may need a newer version than ships with your distro)
-* `Docker <https://store.docker.com/search?type=edition&offering=community>` (and enable for non-root user)
+* Bazel_
+* Docker_ (and enable for non-root user)
 
 These instructions have only been tested on Linux; Windows and MacOS may
 require further changes.
 
+If you need to add dependencies, you will additionally need:
+
+* Dep_
+* Gazelle_
+* Kazel_
+* Buildozer_
+* Git_
+* Mercurial_
 
 Build a dev version of cert-manager
 ===================================
@@ -84,3 +93,14 @@ However, if you make changes to the helm chart or wish to change the controller'
         --set extraArgs="{-v=5}"
         --set image.tag=build
         ./contrib/charts/cert-manager
+
+
+.. _Go: https://golang.org/
+.. _Bazel: https://docs.bazel.build/versions/master/install.html
+.. _Docker: https://store.docker.com/search?type=edition&offering=community
+.. _Dep: https://github.com/golang/dep
+.. _Gazelle: https://github.com/bazelbuild/bazel-gazelle
+.. _Kazel: https://github.com/kubernetes/repo-infra/tree/master/kazel
+.. _Buildozer: https://github.com/bazelbuild/buildtools/tree/master/buildozer
+.. _Git: https://git-scm.com/downloads
+.. _Mercurial: https://www.mercurial-scm.org/

docs/devel/generate-docs.rst

@@ -2,9 +2,8 @@
 Generating Documentation
 =====================
 
-The documentation uses `Sphinx <http://www.sphinx-doc.org/>` (via
+The documentation uses `Sphinx`_ (via `Read The Docs`_) to generate markdown
-`Read The Docs <https://readthedocs.org/>`) to generate markdown from
+ rom `reStructured Text`_.
-`reStructured Text <http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`.
 
 Installation instructions
 =========================
@@ -28,4 +27,8 @@ This will create documentation in the ``_build`` directory which you can
 open with your browser.
 
 Note that you do not need to add these files to your git client, as
-*Read The Docs* will generate the HTML on the fly.
+*Read The Docs* will generate the HTML on the fly.
+
+.. _`Sphinx`: http://www.sphinx-doc.org/
+.. _`Read The Docs`: https://readthedocs.org/
+.. _`reStructured Text`: http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html