1 files changed, 13 insertions, 17 deletions
diff --git a/doc/update/4.2-to-5.0.md b/doc/update/4.2-to-5.0.md
index f8fb607e016..230c1e88b23 100644
--- a/doc/update/4.2-to-5.0.md
+++ b/doc/update/4.2-to-5.0.md
@@ -1,32 +1,32 @@
 # From 4.2 to 5.0
 
 ## Warning
+
 GitLab 5.0 is affected by critical security vulnerability CVE-2013-4490.
 
 ## Important changes
 
-* We don't use `gitlab` user any more. Everything will be moved to `git` user
-* __requires ruby1.9.3__
-
+- We don't use `gitlab` user any more. Everything will be moved to `git` user
+- **requires ruby1.9.3**
 
-__0. Stop gitlab__
+## 0. Stop gitlab
 
     sudo service gitlab stop
 
-__1. add bash to git user__
+## 1. add bash to git user
 
 ```
 sudo chsh -s /bin/bash git
 ```
 
-__2. git clone gitlab-shell__
+## 2. git clone gitlab-shell
 
 ```
 cd /home/git/
 sudo -u git -H git clone https://github.com/gitlabhq/gitlab-shell.git /home/git/gitlab-shell
 ```
 
-__3. setup gitlab-shell__
+## 3. setup gitlab-shell
 
 ```bash
 # chmod all repos and files under git
@@ -55,7 +55,7 @@ ruby -v
 exit
 ```
 
-__4. Copy gitlab instance to git user__
+## 4. Copy gitlab instance to git user
 
 ```bash
 sudo cp -R /home/gitlab/gitlab /home/git/gitlab
@@ -66,7 +66,7 @@ sudo rm -rf /home/gitlab/gitlab-satellites
 sudo rm /tmp/gitlab.socket
 ```
 
-__5. Update gitlab to recent version__
+## 5. Update gitlab to recent version
 
 ```bash
 cd /home/git/gitlab
@@ -110,7 +110,7 @@ sudo chmod -R u+rwX  /home/git/gitlab/tmp/pids
 
 ```
 
-__6. Update init.d script and nginx config__
+## 6. Update init.d script and nginx config
 
 ```bash
 # init.d
@@ -127,14 +127,11 @@ sudo -u git -H cp /home/git/gitlab/config/unicorn.rb.example /home/git/gitlab/co
 sudo vim /etc/nginx/sites-enabled/gitlab
 sudo service nginx restart
 
-
 ```
 
-__7. Start gitlab instance__
+## 7. Start GitLab instance
 
 ```
-
-
 sudo service gitlab start
 
 # check if unicorn and sidekiq started
@@ -145,7 +142,7 @@ ps aux | grep sidekiq
 
 ```
 
-__8. Check installation__
+## 8. Check installation
 
 
 ```bash
@@ -164,5 +161,4 @@ sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
 
 ```
 
-
-__P.S. If everything works as expected you can remove gitlab user from system__
+**P.S. If everything works as expected you can remove gitlab user from system**