diff --git a/doc/raketasks/import.md b/doc/raketasks/import.md
index e78e14804059c679a687a1788d726a2474d24106..45a3bb855ac445e0a4a9a4a26fbb217a3f815981 100644
--- a/doc/raketasks/import.md
+++ b/doc/raketasks/import.md
@@ -1,23 +1,21 @@
-# Import
-
-## Import bare repositories into GitLab project instance
+## Import bare repositories into your GitLab instance
 
 Notes:
 
-- project owner will be a first admin
-- groups will be created as needed
-- group owner will be the first admin
-- existing projects will be skipped
+- The owner of the project will be the first admin
+- The groups will be created as needed
+- The owner of the group will be the first admin
+- Existing projects will be skipped
 
-How to use:
+### How to use:
 
-1. Create a new folder inside the git repositories path. This will be the name of the new group.
+#### Create a new folder inside the git repositories path. This will be the name of the new group.
 
-- For omnibus-gitlab it is located at: `/var/opt/gitlab/git-data/repositories`
-- For manual installations it is usually located at: `/home/git/repositories` or you can see where
+- For omnibus-gitlab, it is located at: `/var/opt/gitlab/git-data/repositories`
+- For manual installations, it is usually located at: `/home/git/repositories` or you can see where
 your repositories are located by looking at `config/gitlab.yml`:
 
-```
+```yaml
 # 3. Advanced settings
 # ==========================
 
@@ -38,7 +36,7 @@ gitlab_shell:
 
 ```
 
-2. Copy your bare repositories inside this newly created folder, e.g.:
+#### Copy your bare repositories inside this newly created folder, e.g.:
 
 ```
 $ cp -r /old/git/foo.git/ /home/git/repositories/new_group/
@@ -46,7 +44,7 @@ $ cp -r /old/git/foo.git/ /home/git/repositories/new_group/
 
 3. Run the commands below depending on you type of installation:
 
-#### Omnibus Installation
+##### Omnibus Installation
 
 ```
 $ sudo gitlab-rake gitlab:import:repos
@@ -55,7 +53,7 @@ $ sudo gitlab-rake gitlab:import:repos
 $ sudo gitlab-rake gitlab:satellites:create
 ```
 
-#### Manual Installation
+##### Manual Installation
 
 Before running these commands you need to change the directory to where your GitLab installation is located:
 
@@ -67,7 +65,7 @@ $ sudo -u git -H bundle exec rake gitlab:import:repos RAILS_ENV=production
 $ sudo -u git -H bundle exec rake gitlab:satellites:create
 ```
 
-#### Example output:
+##### Example output:
 
 ```
 Processing abcd.git