From 19f0bd8302884b562f62638cf024663a7fedf906 Mon Sep 17 00:00:00 2001
From: Jason Blais <jason@spinpunch.com>
Date: Thu, 24 Aug 2017 15:45:05 -0400
Subject: [PATCH] Update README.md (#166)

* Improve update documentation
---
 README.md | 42 ++++++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index ff692b6..35de761 100644
--- a/README.md
+++ b/README.md
@@ -76,39 +76,49 @@ Put your SSL certificate as `./volumes/web/cert/cert.pem` and the private key th
 no password as `./volumes/web/cert/key-no-password.pem`. If you don't have
 them you may generate a self-signed SSL certificate.
 
-## Starting/Stopping
+### Starting/Stopping Docker
 
-### Start
+#### Start
 ```
 docker-compose start
 ```
 
-### Stop
+#### Stop
 ```
 docker-compose stop
 ```
 
-### Update
+### Removing Docker
+
+#### Remove the containers
+```
+docker-compose stop && docker-compose rm
+```
+
+#### Remove the data and settings of your Mattermost instance
+```
+sudo rm -rf volumes
+```
+
+## Update Mattermost to latest version
+
+First, shutdown your containers to back up your data.
 
-Make sure to backup Mattermost data before proceeding.
 ```
 docker-compose down
+```
+
+Back up your mounted volumes to save your data. If you use the default `docker-compose.yml` file proposed on this repository, your data is on `./volumes/` folder.
+
+Then run the following commands.
+
+```
 git pull
 docker-compose build
 docker-compose up -d
 ```
 
-## Removing
-
-### Remove the containers
-```
-docker-compose stop && docker-compose rm
-```
-
-### Remove the data and settings of your Mattermost instance
-```
-sudo rm -rf volumes
-```
+Your Docker image should now be on the latest Mattermost version.
 
 ## Upgrading to Team Edition 3.0.x from 2.x