diff --git a/README.md b/README.rst
similarity index 100%
rename from README.md
rename to README.rst
diff --git a/compose/README.md b/compose/README.rst
similarity index 100%
rename from compose/README.md
rename to compose/README.rst
diff --git a/demos/heat/README.md b/demos/heat/README.rst
similarity index 100%
rename from demos/heat/README.md
rename to demos/heat/README.rst
diff --git a/demos/magnum/redis-kube/README.md b/demos/magnum/redis-kube/README.rst
similarity index 100%
rename from demos/magnum/redis-kube/README.md
rename to demos/magnum/redis-kube/README.rst
diff --git a/devenv/README.md b/devenv/README.rst
similarity index 100%
rename from devenv/README.md
rename to devenv/README.rst
diff --git a/docs/ansible-deployment.md b/docs/ansible-deployment.rst
similarity index 100%
rename from docs/ansible-deployment.md
rename to docs/ansible-deployment.rst
diff --git a/docs/dev-quickstart.md b/docs/dev-quickstart.rst
similarity index 100%
rename from docs/dev-quickstart.md
rename to docs/dev-quickstart.rst
diff --git a/docs/image-building.md b/docs/image-building.rst
similarity index 100%
rename from docs/image-building.md
rename to docs/image-building.rst
diff --git a/docs/vagrant.md b/docs/vagrant.rst
similarity index 100%
rename from docs/vagrant.md
rename to docs/vagrant.rst