diff --git a/Puppetfile b/Puppetfile
index 2db19b4..1277ebe 100644
--- a/Puppetfile
+++ b/Puppetfile
@@ -1,5 +1,17 @@
+# This file manages Puppet module dependencies.
+#
+# It works a lot like Bundler. We provide some core modules by default.
+# This ensures at least the ability to construct a basic environment.
+
+# Includes many of our custom types and providers, as well as global config.
+# Required.
+mod "boxen", "0.0.1.1", :github_tarball => "boxen/puppet-boxen"
+
+# Core modules for a basic development environment.
+# You can replace some/most of those if you want, but it's not recommended.
 %w(ruby rbenv nvm nodejs git hub inifile sudo homebrew xcode).each do |modulename|
   mod modulename, "0.0.1", :github_tarball => "boxen/puppet-#{modulename}"
 end
 
-mod "boxen", "0.0.1.1", :github_tarball => "boxen/puppet-boxen"
+# Add your custom modules here.
+# There are tons available at https://github.com/boxen.
\ No newline at end of file