diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4b87ac4cff9..5f8314462a2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,4 +1,4 @@
-## Contribute to GitLab 
+## Contribute to GitLab
 
 If you want to contribute to GitLab, follow this process:
 
@@ -7,24 +7,20 @@ If you want to contribute to GitLab, follow this process:
 3. Code
 4. Create a pull request
 
-We will only accept pull requests if: 
+We will only accept pull requests if:
 
 * Your code has proper tests and all tests pass
-* Your code can be merged w/o problems 
+* Your code can be merged w/o problems
 * It won't break existing functionality
 * It's quality code
 * We like it :)
 
-## [You may need a developer VM](https://github.com/gitlabhq/developer-vm)
+For examples of feedback on pull requests please look at the [closed pull requests](https://github.com/gitlabhq/gitlabhq/pulls?direction=desc&page=1&sort=created&state=closed).
+
+## Installation
+
+Install the Gitlab development in a virtual machine with the [Gitlab Vagrant virtual machine](https://github.com/gitlabhq/gitlab-vagrant-vm). Installing it in a virtual machine makes it much easier to set up all the dependencies for integration testing.
 
 ## Running tests
 
-To run the specs for GitLab, you need to run seeds for test db.
-
-    cd gitlabhq
-    rake db:seed_fu RAILS_ENV=test
-
-Then you can run the test suite with rake:
-
-    rake gitlab:test
-
+For more information on running the tests please read the [development tips](https://github.com/gitlabhq/gitlabhq/blob/master/doc/development.md)
diff --git a/doc/development.md b/doc/development.md
index 67bcb8e1c96..ef6a9b02757 100644
--- a/doc/development.md
+++ b/doc/development.md
@@ -1,45 +1,36 @@
-## Development tips: 
+## Development tips:
+
+
+### Installation
+
+Install the Gitlab development in a virtual machine with the [Gitlab Vagrant virtual machine](https://github.com/gitlabhq/gitlab-vagrant-vm). Installing it in a virtual machine makes it much easier to set up all the dependencies for integration testing.
+
 
 ### Start application in development mode
 
-#### 1. Via foreman 
-
-    bundle exec foreman -p 3000
-
-#### 2. Via gitlab cli
+#### 1. Via gitlab cli
 
     ./gitlab start
 
-#### 3. Manually
+#### 2. Manually
 
-   bundle exec rails s
-   bundle exec rake environment resque:work QUEUE=* VVERBOSE=1
+    bundle exec rails s
+    bundle exec rake environment resque:work QUEUE=* VVERBOSE=1
 
 
-### Run tests: 
- 
-#### 1. Packages
-
-    # ubuntu
-    sudo apt-get install libqt4-dev libqtwebkit-dev
-    sudo apt-get install xvfb
-   
-    # Mac 
-    brew install qt
-    brew install xvfb
-
-#### 2. DB & seeds
+### Test DB seutup & seed
 
     bundle exec rake db:setup RAILS_ENV=test
     bundle exec rake db:seed_fu RAILS_ENV=test
 
-###  3. Run Tests
+
+###  Run the Tests
 
     # All in one
     bundle exec rake gitlab:test
-    
-    # Rspec 
+
+    # Rspec
     bundle exec rake spec
-    
+
     # Spinach
     bundle exec rake spinach