Add generators to the guides and break out an extensions section

2 files changed, 24 insertions, 12 deletions

diff --git a/railties/guides/source/index.html.erb b/railties/guides/source/index.html.erb
index 52da16d453..f47975917c 100644
--- a/railties/guides/source/index.html.erb
+++ b/railties/guides/source/index.html.erb
@@ -88,10 +88,6 @@ Ruby on Rails Guides
 
 <dl>
 
-<%= guide("Rails on Rack", 'rails_on_rack.html') do %>
-  <p>This guide covers Rails integration with Rack and interfacing with other Rack components.</p>
-<% end %>
-
 <%= guide("Rails Internationalization API", 'i18n.html') do %>
   <p>This guide covers how to add internationalization to your applications. Your application will be able to translate content to different languages, change pluralization rules, use correct date formats for each country and so on.</p>
 <% end %>
@@ -116,10 +112,6 @@ Ruby on Rails Guides
   <p>This guide covers the various ways of performance testing a Ruby on Rails application.</p>
 <% end %>
 
-<%= guide("The Basics of Creating Rails Plugins", 'plugins.html', :ticket => 32) do %>
-  <p>This guide covers how to build a plugin to extend the functionality of Rails.</p>
-<% end %>
-
 <%= guide("Configuring Rails Applications", 'configuring.html') do %>
   <p>This guide covers the basic configuration settings for a Rails application.</p>
 <% end %>
@@ -137,6 +129,24 @@ Ruby on Rails Guides
 <% end %>
 </dl>
 
+<h3>Extending Rails</h3>
+
+<dl>
+  <%= guide("The Basics of Creating Rails Plugins", 'plugins.html', :ticket => 32) do %>
+    <p>This guide covers how to build a plugin to extend the functionality of Rails.</p>
+  <% end %>
+
+  <%= guide("Rails on Rack", 'rails_on_rack.html') do %>
+    <p>This guide covers Rails integration with Rack and interfacing with other Rack components.</p>
+  <% end %>
+
+  <%= guide("Adding Generators", 'generators.html') do %>
+    <p>This guide covers the process of adding a brand new generator to your extension
+      or providing an alternative to an element of a built-in Rails generator (such as
+      providing alternative test stubs for the scaffold generator)</p>
+  <% end %>
+</dl>
+
 <h3>Release Notes</h3>
 
 <dl>
diff --git a/railties/guides/source/layout.html.erb b/railties/guides/source/layout.html.erb
index b280101d25..f1727166ba 100644
--- a/railties/guides/source/layout.html.erb
+++ b/railties/guides/source/layout.html.erb
@@ -68,14 +68,16 @@
               <dd><a href="security.html">Securing Rails Applications</a></dd>
               <dd><a href="debugging_rails_applications.html">Debugging Rails Applications</a></dd>
               <dd><a href="performance_testing.html">Performance Testing Rails Applications</a></dd>
-              <dd><a href="plugins.html">The Basics of Creating Rails Plugins</a></dd>
               <dd><a href="configuring.html">Configuring Rails Applications</a></dd>
-              <dd><a href="rails_on_rack.html">Rails on Rack</a></dd>
               <dd><a href="command_line.html">Rails Command Line Tools and Rake Tasks</a></dd>
               <dd><a href="caching_with_rails.html">Caching with Rails</a></dd>
               <dd><a href="contributing_to_rails.html">Contributing to Rails</a></dd>
-            </dl>
-            <dl class="R">
+
+              <dt>Extending Rails</dt>
+              <dd><a href="plugins.html">The Basics of Creating Rails Plugins</a></dd>
+              <dd><a href="rails_on_rack.html">Rails on Rack</a></dd>
+              <dd><a href="generators.html">Adding a Generator to Your Plugin</a></dd>
+
               <dt>Release Notes</dt>
               <dd><a href="3_0_release_notes.html">Ruby on Rails 3.0 Release Notes</a></dd>
               <dd><a href="2_3_release_notes.html">Ruby on Rails 2.3 Release Notes</a></dd>