diff --git a/docs/commands.md b/docs/commands.md
index 9f6f91e0a..ee499d21c 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -15,6 +15,7 @@ $ vagrant
 vagrant
 vagrant-box
 vagrant-down
+vagrant-halt
 vagrant-init
 vagrant-package
 vagrant-reload
@@ -31,16 +32,18 @@ Each binary has its own documentation associated with it as well. By running
 `vagrant help COMMAND`, the documentation will show for the given command.
 But we'll go over each binary here, as well.
 
-The commands are documented in the order "most useful" or "most used." While
-this may be annoying for reference needs, the titles of each section are simply
-the command, so you can easily use the browser search to find any command you're
-looking for.
-
 <a name="vagrant-box"> </a>
 ## vagrant box
 
 Boxes have there own section: [Vagrant Boxes](/docs/boxes.html)
 
+<a name="vagrant-halt"> </a>
+## vagrant halt
+
+This halts the running virtual machine immediately by essentially "pulling the power."
+It is a force shutdown. If possible, we recommend that virtual machines be shut down
+gracefully by setting up a [rake task](/docs/rake.html) or using [`vagrant ssh`](#vagrant-ssh) to shut it down.
+
 <a name="vagrant-init"> </a>
 ## vagrant init
 
diff --git a/docs/provisioning.md b/docs/provisioning.md
index 092eac0b5..cd478947b 100644
--- a/docs/provisioning.md
+++ b/docs/provisioning.md
@@ -86,7 +86,10 @@ By default, Vagrant JSON configuration looks like the following:
 {% highlight ruby %}
 {
   :instance_role => "vagrant",
-  :project_directory => "/vagrant", # Or wherever your project directory is setup
+  :vagrant => {
+    :config => { ... }, # Full Vagrant config
+    :directory => "/vagrant" # Or wherever configured project directory is
+  }
 }
 {% endhighlight %}