diff --git a/README.rst b/README.rst
index 727bde1f35..2d6ad79e76 100644
--- a/README.rst
+++ b/README.rst
@@ -31,7 +31,7 @@ Docker Images
 The `Docker images <https://docs.docker.com/userguide/dockerimages/>`__
 are built by the Kolla project maintainers. A detailed process for
 contributing to the images can be found in the `image building
-guide <https://github.com/stackforge/kolla/blob/master/docs/image-building.md>`__.
+guide <https://github.com/stackforge/kolla/blob/master/docs/image-building.rst>`__.
 Images reside in the Docker Hub `Kollaglue
 repo <https://registry.hub.docker.com/repos/kollaglue/>`__.
 
diff --git a/demos/magnum/redis-kube/README.rst b/demos/magnum/redis-kube/README.rst
index 06a927f26c..0a0ede6ab6 100644
--- a/demos/magnum/redis-kube/README.rst
+++ b/demos/magnum/redis-kube/README.rst
@@ -25,7 +25,7 @@ Turning up an initial master/sentinel pod.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 is a
-`*Pod* <https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/pods.md>`__.
+`*Pod* <https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/user-guide/pods.md>`__.
 A Pod is one or more containers that *must* be scheduled onto the same
 host. All containers in a pod share a network namespace, and may
 optionally share mounted volumes.
diff --git a/docs/dev-quickstart.rst b/docs/dev-quickstart.rst
index 57e38a7008..89d8ee1a2e 100644
--- a/docs/dev-quickstart.rst
+++ b/docs/dev-quickstart.rst
@@ -130,7 +130,7 @@ Starting Kolla
 --------------
 
 Configure Ansible by reading the
-`Kolla Ansible configuration Guide <https://github.com/stackforge/kolla/blob/master/docs/ansible-deployment.md>`__ documentation.
+`Kolla Ansible configuration Guide <https://github.com/stackforge/kolla/blob/master/docs/ansible-deployment.rst>`__ documentation.
 
 Finally, run the deploy operation: