Merge pull request #19 from bonitasoft/fix/dockerfile_reference

fix(docker): rephrase references to BCD controller Dockerfile

md/docker.md

-# Docker image to launch Bonita Provisioning Ansible playbooks
+# BCD controller Docker image
 
-This Docker image provides a ready-to-use environment to launch Bonita Provisioning Ansible playbooks.
+This Docker image provides a ready-to-use environment to launch Bonita Continuous Delivery Ansible playbooks.
 
 ## Install the image
 
 ### From pre-built image
 
-A pre-built image might be available here as a `bcd-controller_<version>.tar.gz` file. Load this image into Docker engine as follows:
+A pre-built BCD controller image is provided with BCD deliverable as a `bcd-controller_<version>.tar.gz` archive. It is located in the `ansible_<version>/docker` directory.
+
+Load this image into Docker engine as follows:
 ```
+$ cd ansible_<version>/docker
 $ gunzip -c bcd-controller_<version>.tar.gz | docker load
+Loaded image: bonitasoft/bcd-controller:<version>
+Loaded image: bonitasoft/bcd-controller:latest
 ```
 
 ### From source
 
-You can also build the image from source as follows:
+You can also build the image from source. Its Dockerfile is provided with BCD deliverable in the `ansible_<version>/docker` directory.
+
+Build the image as follows:
 ```
+$ cd ansible_<version>/docker
 $ docker build -t bonitasoft/bcd-controller .
 ```
 
@@ -35,6 +43,10 @@ aws_secret_access_key = <YOUR_AWS_SECRET_ACCESS_KEY>
 ### Start a container
 
 ```
-$ docker run --rm -t -i --name bcd-controller -v <local_path_to_.boto>:/home/bonita/.boto -v <local_path_to_ansible_folder>:/home/bonita/ansible -v <local_path_to_ssh_private_key>:/home/bonita/.ssh/<ssh_private_key> bonitasoft/bcd-controller /bin/bash
+$ docker run --rm -t -i --name bcd-controller \
+    -v <local_path_to_.boto>:/home/bonita/.boto \
+    -v <local_path_to_ansible_folder>:/home/bonita/ansible \
+    -v <local_path_to_ssh_private_key>:/home/bonita/.ssh/<ssh_private_key> \
+    bonitasoft/bcd-controller /bin/bash
 $ cd /home/bonita/ansible
 ```

md/index.md

@@ -125,7 +125,9 @@ $ bcd -s scenarios/uswest_performance.yml --yes destroy
 
 ### Installing a custom BCD Controller
 
-To use this tool without the BCD Controller Docker image you can directly follow the setup described inside the [Dockerfile](./docker/Dockerfile) in order to setup your own environment
+In order to setup your own environment without the [BCD Controller Docker image](docker.md), you can follow the installation procedure described in its Dockerfile.
+
+The BCD controller Dockerfile is provided with BCD deliverable in the `ansible_<version>/docker` directory.
 
 ### Debugging Facts
 
@@ -136,7 +138,9 @@ $ ansible all -vv -i inventory/ec2/ec2_wrapper.sh -m setup -u ubuntu --tree tmp_
 This command will identify every EC2 instance (regardless of `bcd_stack_id`) and put its facts into the `tmp_facts` directory.
 
 ### Dive into the scenarios
-For further details see [this section](scenarios.md)
+
+For further details see [this section](scenarios.md).
 
 ## Known issues
-For further details see [this section](known_issues.md)
+
+For further details see [this section](known_issues.md).