1 files changed, 21 insertions, 14 deletions
diff --git a/doc/update.markdown b/doc/update.markdown
index 0c59a85e..3233adcb 100644
--- a/doc/update.markdown
+++ b/doc/update.markdown
@@ -1,26 +1,33 @@
-Update
-======
+Upgrade Kanboard to a new version
+=================================
 
-**Always make a backup of your database before upgrading!**
+Upgrading Kanboard to a newer version is seamless.
+The process can be summarized to simply copy your data folder to the new Kanboard folder.
+Kanboard will run automatically database migrations for you.
+
+Important things to do before updating
+--------------------------------------
+
+- Always make a backup of your data before upgrading
+- Always read the [change log](https://github.com/fguillot/kanboard/blob/master/ChangeLog) to check for breaking changes
+- Always close all user sessions (flush all sessions on the server)
 
 From the archive (stable version)
 ---------------------------------
 
-1. Close all sessions (logout)
-2. Rename your actual Kanboard directory (to keep a backup)
-3. Uncompress the new archive and copy your `data` directory to the newly uncompressed directory.
-4. Copy your custom `config.php` (if you created one) to the root of the newly uncompressed directory.
-5. Make the directory `data` writeable by the web server user
-6. Login and check if everything is ok
-7. Remove the old Kanboard directory
-
+1. Uncompress the new archive
+2. Copy the content of your data folder into the newly uncompressed directory
+3. Copy your custom `config.php` if you have one
+4. Copy your plugins if necessary
+5. Make sure the directory `data` is writeable by your web server user
+6. Test
+7. Remove your old Kanboard directory
 
 From the repository (development version)
 -----------------------------------------
 
-1. Close all sessions
-2. `git pull`
-3. `composer install`
+1. `git pull`
+2. `composer install`
 3. Login and check if everything is ok
 
 Note: This method will install the **current development version**, use at your own risk.