Update docs to markdown style guide.

1 files changed, 16 insertions, 17 deletions

diff --git a/doc/update/5.1-to-5.4.md b/doc/update/5.1-to-5.4.md
index 56f4854daf0..53dbfd00ad4 100644
--- a/doc/update/5.1-to-5.4.md
+++ b/doc/update/5.1-to-5.4.md
@@ -1,21 +1,21 @@
 # From 5.1 to 5.4
+
 Also works starting from 5.2.
 
-### 0. Backup
+## 0. Backup
 
-It's useful to make a backup just in case things go south:
-(With MySQL, this may require granting "LOCK TABLES" privileges to the GitLab user on the database version)
+It's useful to make a backup just in case things go south (with MySQL, this may require granting "LOCK TABLES" privileges to the GitLab user on the database version):
 
 ```bash
 cd /home/git/gitlab
 sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
 ```
 
-### 1. Stop server
+## 1. Stop server
 
     sudo service gitlab stop
 
-### 2. Get latest code
+## 2. Get latest code
 
 ```bash
 cd /home/git/gitlab
@@ -23,7 +23,7 @@ sudo -u git -H git fetch
 sudo -u git -H git checkout 5-4-stable # Latest version of 5-4-stable addresses CVE-2013-4489
 ```
 
-### 3. Update gitlab-shell
+## 3. Update gitlab-shell
 
 ```bash
 cd /home/git/gitlab-shell
@@ -31,7 +31,7 @@ sudo -u git -H git fetch
 sudo -u git -H git checkout v1.7.9 # Addresses multiple critical security vulnerabilities
 ```
 
-### 4. Install libs, migrations, etc.
+## 4. Install libs, migrations, etc.
 
 ```bash
 cd /home/git/gitlab
@@ -47,12 +47,12 @@ sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
 sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production
 ```
 
-### 5. Update config files
+## 5. Update config files
 
-* Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example but with your settings.
-* Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example but with your settings.
+- Make `/home/git/gitlab/config/gitlab.yml` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/gitlab.yml.example but with your settings.
+- Make `/home/git/gitlab/config/puma.rb` same as https://gitlab.com/gitlab-org/gitlab-ce/blob/5-4-stable/config/puma.rb.example but with your settings.
 
-### 6. Update Init script
+## 6. Update Init script
 
 ```bash
 sudo rm /etc/init.d/gitlab
@@ -60,7 +60,7 @@ sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab
 sudo chmod +x /etc/init.d/gitlab
 ```
 
-### 7. Create uploads directory
+## 7. Create uploads directory
 
 ```bash
 cd /home/git/gitlab
@@ -68,13 +68,12 @@ sudo -u git -H mkdir public/uploads
 sudo chmod -R u+rwX  public/uploads
 ```
 
-
-### 8. Start application
+## 8. Start application
 
     sudo service gitlab start
     sudo service nginx restart
 
-### 9. Check application status
+## 9. Check application status
 
 Check if GitLab and its environment are configured correctly:
 
@@ -89,8 +88,8 @@ If all items are green, then congratulations upgrade complete!
 ## Things went south? Revert to previous version (5.3)
 
 ### 1. Revert the code to the previous version
-Follow the [`upgrade guide from 5.2 to 5.3`](5.2-to-5.3.md), except for the database migration 
-(The backup is already migrated to the previous version)
+
+Follow the [`upgrade guide from 5.2 to 5.3`](5.2-to-5.3.md), except for the database migration (the backup is already migrated to the previous version).
 
 ### 2. Restore from the backup: