diff --git a/Library/Homebrew/cmd/create.rb b/Library/Homebrew/cmd/create.rb
index ecdb9e0316..0e3e39a106 100644
--- a/Library/Homebrew/cmd/create.rb
+++ b/Library/Homebrew/cmd/create.rb
@@ -98,7 +98,8 @@ class FormulaCreator
   def template; <<-EOS.undent
     require 'formula'
 
-    # REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST!
+    # Documentation: https://github.com/mxcl/homebrew/wiki/Formula-Cookbook
+    # PLEASE REMOVE ALL GENERATED COMMENTS BEFORE SUBMITTING YOUR PULL REQUEST!
 
     class #{Formula.class_s name} < Formula
       homepage ''
@@ -112,6 +113,9 @@ class FormulaCreator
     <% end %>
 
       def install
+        # ENV.x11 # if your formula requires any X11 headers
+        # ENV.j1  # if your formula's build system can't parallelize
+
     <% if mode == :cmake %>
         system "cmake . \#{std_cmake_parameters}"
     <% elsif mode == :autotools %>
@@ -122,15 +126,13 @@ class FormulaCreator
                               "--prefix=\#{prefix}"
         # system "cmake . \#{std_cmake_parameters}"
     <% end %>
-        # if this fails, try separate make/make install steps
-        system "make install"
+        system "make install" # if this fails, try separate make/make install steps
       end
 
       def test
-        # This test will fail and we won't accept that! It's enough to just
-        # replace "false" with the main program this formula installs, but
-        # it'd be nice if you were more thorough. Test the test with
-        # `brew test #{name}`.
+        # This test will fail and we won't accept that! It's enough to just replace
+        # "false" with the main program this formula installs, but it'd be nice if you
+        # were more thorough. Run the test with `brew test #{name}`.
         system "false"
       end
     end