Add Sphinx rst based documentation for readthedocs

docs/deploy/README.md → contrib/manifests/cert-manager/README.md

@@ -10,6 +10,6 @@ Helm, or want to inspect a 'bare minimum' deployment.
 
 The manifests in these subdirectories are generated from the Helm chart
 automatically. The `values.yaml` files used to configure cert-manager can be
-found in [`hack/deploy`](../../hack/deploy/).
+found in [`hack/deploy`](../../../hack/deploy/).
 
 They are automatically generated by running `./hack/update-deploy-gen.sh`.

docs/.gitignore

@@ -0,0 +1 @@
+_build/

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = cert-manager
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_static/css/style.css

@@ -0,0 +1,5 @@
+/* Temporary fix for https://github.com/rtfd/sphinx_rtd_theme/issues/417 */
+
+.rst-content .highlight>pre {
+    line-height: 18px !important;
+}