diff --git a/ansible/README.rst b/ansible/README.rst
index 33e31c3b..e0dfd7dc 100644
--- a/ansible/README.rst
+++ b/ansible/README.rst
@@ -18,13 +18,17 @@ Prerequisites
 -  Ansible 2.0 or higher
 -  SSH key to the servers
 
-Optional for DigitalOcean droplets: \* DigitalOcean API Token \* python
-dopy package
+Optional for DigitalOcean droplets:
+
+- DigitalOcean API Token
+- python dopy package
 
 For a description on how to get a DigitalOcean API Token, see the explanation
-in the `using terraform tutorial <terraform-digitalocean.rst>`__.
+in the `using terraform tutorial <./terraform-digitalocean.html>`__.
 
-Optional for Amazon AWS instances: \* Amazon AWS API access key ID and
+Optional for Amazon AWS instances: 
+
+- Amazon AWS API access key ID and
 secret access key.
 
 The cloud inventory scripts come from the ansible team at their
diff --git a/mintnet-kubernetes/README.rst b/mintnet-kubernetes/README.rst
index 627cadd7..1baca679 100644
--- a/mintnet-kubernetes/README.rst
+++ b/mintnet-kubernetes/README.rst
@@ -52,7 +52,8 @@ then query the Tendermint app logs from the first pod:
 
 ``kubectl logs -c tm -f tm-0``
 
-finally, use `Rest API <rpc.html>`__ to fetch the status of the second pod's Tendermint app.
+finally, use our `Rest API <../specification/rpc.html>`__ to fetch the status of the second pod's Tendermint app.
+
 Note we are using ``kubectl exec`` because pods are not exposed (and should not be) to the
 outer network: