diff --git a/README.markdown b/README.markdown
index d8e4f3c..65678a9 100644
--- a/README.markdown
+++ b/README.markdown
@@ -7,16 +7,21 @@ thoughtbot's Suspenders modified for Heroku.
     cd heroku_suspenders
     ./script/create_project project_name
 
-This will create a Rails 2.3.2 app with:
+This will create a Rails 2.3.2 app with Heroku-recommended code:
 
 * Paperclip for file uploads, set for Amazon S3
-* Clearance for authentication
 * Gmail SMTP for email
-* Cucumber, Shoulda, Factory Girl, & Mocha for testing
 * Delayed Job for background processing
 * Hoptoad Notifier for exception notification
 * Google Analytics for usage analytics
-* Coulda for model, controller, & helper generators
+
+... and some other opinions:
+
+* jQuery for Javascript
+* Clearance for authentication
+* Cucumber, Shoulda, Factory Girl, & Mocha for testing
+* Stylus for CSS framework
+* Coulda for features, model, controller, & helper generators
 
 Get the latest & greatest at anytime with:
 
diff --git a/doc/README_FOR_TEMPLATE b/doc/README_FOR_TEMPLATE
index 5f75490..5d6169c 100644
--- a/doc/README_FOR_TEMPLATE
+++ b/doc/README_FOR_TEMPLATE
@@ -106,6 +106,26 @@ from Joe Ferris that adds test spies (assert_received) to Mocha.
 
     jferris-mocha --version '0.9.5.0.1241126838' --source gems.github.com
 
+Javascript
+----------
+
+jQuery and jRails are included.
+
+Styles
+------
+
+Heroku's Suspenders includes a lightweight CSS framework called Stylus.
+
+public/stylesheets/screen.css is included in the application layout.
+It imports the Stylus framework:
+
+    @import url("framework/reset.css");
+    @import url("framework/typography.css");
+    @import url("framework/layout.css");
+    @import url("framework/forms.css");
+
+Add another import for your own styles, by convention named after your app.
+
 Mascot
 ------
 
--
libgit2 0.21.2