Fix typo in the documentation

README.md

@@ -1,43 +1,58 @@
-This project supplies a usable environment in order to make tests around [OpenStack][1] using [CockroachDB][2] as a backend for its services.
+This project supplies a usable environment in order to make tests around [OpenStack/pike][1] using [CockroachDB][2] as a backend for its services.
 
-This project is developed in the context of the [Discovery][3] initiative.
+List of current supported services:
+* Keystone
+
+This project is developed in the context of the Inria [Discovery][3] initiative.
 
 # Getting started
 
 ## Set up the environment
 ### Deploying your VM(s)
-To run this project you have to install [vagrant][4]. Once installed and configured, deploy your VM(s) using `vagrant up x`. You can deploy choose either CockroachDB or PostgreSQL as backend but you can also deploy two VMs using one each to make some comparisons for instance.
-* `vagrant up cockroachdb` to deploy a VM which will use CockroachDB as backend for OpenStack' services.
-* `vagrant up psql` to deploy a VM which will use PostgreSQL as backend for OpenStack' services.
-* `vagrant up` to deploy two VMs, one using CockroachDB and the other using PostgreSQL.
-
-
+To run this project you have to install [vagrant][4]. Once installed, deploy your VM(s) and run [Devstack][6] using `vagrant up --provision`. Devstack then deploys OpenStack with either CockroachDB or PostgreSQL as a backend. Note that, for now Devstack project only deploys Keystone and Rally services.
+* `vagrant up cockroachdb --provision` deploys a VM which will use CockroachDB as backend for OpenStack services.
+* `vagrant up psql --provision` deploys a VM which will use PostgreSQL as backend for OpenStack services.
+* `vagrant up --provision` deploys two VMs, one using CockroachDB and the other using PostgreSQL.
+
+Once the shell displays the following message:
+```
+TASK [Start of Devstack deployment] ********************************************
+ok: [cockroachdb] => {
+    "msg": [
+        "Follow deployment with:",
+        "vagrant ssh cockroachdb -- tail -f /tmp/stack-logs"
+    ]
+}
+```
+
+Run the command `vagrant ssh cockroachdb -- tail -f /tmp/stack-logs` in another shell to follow the deployment of OpenStack.
+
+
+<!---
 You can also allow keystone debugging mode (_keystone-wsgi-admin_) by setting setting DEBUG to true in [Vagrantfile](Vagrantfile#L6).
+--->
+
 
 #### Deploying on Grid5000 platform.
 You can easily deploy this project on Grid5000 platform using [vagrant-g5k plugin][5].
-* `vagrant up [backend] --provider=g5k`
-
-### Deploying OpenStack
-Once your VM is deployed, you are able to deploy OpenStack using [Devstack][6]. For now, this project only deploy Keystone and Rally services.
-* `vagrant provision [backend]`
+* `vagrant up [sql-backend] --provider=g5k`
 
-## Jump onto your VM and start using Openstack cli
+## Jump onto your VM and start using OpenStack cli
 
-* Jump onto you WM using `vagrant ssh [backend]`.
-* Start to use the Openstack cli by switching to **stack** user with `sudo su stack`.
-* Once here you can use openstack cli to create a new project for instance `openstack project create keystone --or-show`
-* You can also use Rally to run some scenarii over Keystone (e.g. `rally task start /opt/stack/rally/samples/tasks/scenarios/keystone/create-and-delete-user.yaml`) 
+* Jump onto you WM using `vagrant ssh [sql-backend]`.
+* Start to use the OpenStack cli by switching to **stack** user with `sudo su stack`.
+* Once here you can use OpenStack cli to create a new project for instance `openstack project create keystone --or-show`
+* You can also use Rally to run some scenarii over Keystone (e.g. `rally task start /opt/stack/rally/samples/tasks/scenarios/keystone/create-and-delete-user.yaml`)
 
 # Limitations
 
-Until now, this project is only deploying Keystone service with a cockroachDB backend and we had to skip databases migrations due to some problems with sqlalchemy-migrate. To bypass migrations we deployed a posgreSQL-backended Keystone and dumped its database and apply this dump to our cockroachDB-backended Keystone.  
+Until now, this project is only deploying Keystone service with CockroachDB as backend. We had to skip databases migrations due to incompatibilites between sqlalchemy-migrate and CockroachDB. To bypass migrations we deployed a PostgreSQL-backended Keystone and dumped its database and then apply this dump to our CockroachDB-backended Keystone.
 
 # Future work
 
 * Deal with sqlalchemy-migrate migrations.
 * Make some benchmark to show out differences with a standard mysql-backended Keystone.
-* Expand this tool to other Openstack services.
+* Expand this tool to other OpenStack services.
 
 # Links
 
@@ -54,4 +69,4 @@ Until now, this project is only deploying Keystone service with a cockroachDB ba
 [3]: https://beyondtheclouds.github.io/
 [4]: https://vagrantup.com/
 [5]: https://github.com/msimonin/vagrant-g5k
-[6]: https://github.com/openstack-dev/devstack
+[6]: https://docs.openstack.org/devstack/latest/