diff --git a/README.md b/README.md
deleted file mode 100644
index 57bd321..0000000
--- a/README.md
+++ /dev/null
@@ -1,42 +0,0 @@
-OpenStack groups portal
-=======================
-
-Prerequisites
--------------
-
-* drush 7.x-5.8
-* LAMP environment capable of running Drupal 7.x
-
-Build distribution
-==================
-
-make stub file
----------------
-
-Create build-groups.make file with following content:
-```
-api = 2
-core = 7.x
-
-; Include the definition of how to build Drupal core directly, including patches.
-includes[] = "drupal-org-core.make"
-
-; Download the Groups install profile and recursively build all its dependencies.
-projects[groups][type] = "profile"
-projects[groups][download][type] = "git"
-projects[groups][download][url] = "https://github.com/openstack-infra/groups.git"
-projects[groups][download][branch] = "master"
-```
-
-make distribution
------------------
-
-```bash
-$> drush make build-groups.make groups-dev.local
-```
-
-release tarballs
-----------------
-
-Development and release tarballs available at http://tarballs.openstack.org/groups
-
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..7c557ea
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,20 @@
+OpenStack groups portal
+***********************
+
+Prerequisites
+=============
+
+* drush 7.x-5.8
+* LAMP environment capable of running Drupal 7.x
+
+Build distribution
+==================
+
+Run the following command to build the distribution:
+
+    $ drush make build-groups.make groups-dev.local
+
+Release tarballs
+================
+
+Development and release tarballs are available at http://tarballs.openstack.org/groups.