diff --git a/DEVELOPER-ADVANCED.md b/DEVELOPER-ADVANCED.md
index cbbe261cc73..89cc2594109 100644
--- a/DEVELOPER-ADVANCED.md
+++ b/DEVELOPER-ADVANCED.md
@@ -1,9 +1,7 @@
 # Discourse Advanced Developer Install Guide
 
 This guide is aimed at advanced Rails developers who have installed their own Rails apps before. If you are new
-to rails, you are likely much better off with our **[Discourse Advanced Developer Guide](https://github.com/discourse/discourse/blob/master/DEVELOPER-ADVANCED.md)**.
-The advanced guide also contains instructions on how to provision your own Vagrant VM.
-
+to rails, you are likely much better off with our **[Discourse Vagrant Developer Guide](https://github.com/discourse/discourse/blob/master/VAGRANT.md)**.
 
 ## First Steps
 
@@ -27,7 +25,7 @@ The advanced guide also contains instructions on how to provision your own Vagra
 You should now be able to connect to rails on http://localhost:3000 - try it out! The seed data includes a pinned topic that explains how to get an admin account, so start there! Happy hacking!
 
 
-# Provisioning a Vagrant VM:
+# Building your own Vagrant VM
 
 Here are the steps we used to create the **[Vagrant Virtual Machine](https://github.com/discourse/discourse/blob/master/VAGRANT.md)**. They might be useful if you plan on setting up an environment from scratch on Linux:
 
diff --git a/VAGRANT.md b/VAGRANT.md
index 675db3fc309..5addb73ef17 100644
--- a/VAGRANT.md
+++ b/VAGRANT.md
@@ -1,6 +1,8 @@
 # Discourse Developer Install Guide (Vagrant)
 
 If you'd like to set up a development environment for Discourse, the easiest way is by using a virtual machine.
+If you have experience setting up Rails projects, you might want to take a look at our **[Discourse Advanced Developer Guide](https://github.com/discourse/discourse/blob/master/DEVELOPER-ADVANCED.md)**.
+It also contains instructions on building your own Vagrant VM.
 
 The following instructions will automatically download and provision a virtual machine for you to begin hacking
 on Discourse with: