Update guides/source/routing.md

rails · Sep 25, 2012 · 2029c2a · 2029c2a
1 parent bfafa99
commit 2029c2a
Showing 1 changed file with 12 additions and 0 deletions.
diff --git a/guides/source/routing.md b/guides/source/routing.md
@@ -401,6 +401,18 @@ resources :photos do
 end
 ```
 
+#### Adding Routes for Additional New Actions
+
+To add an alternate new action using the `:on` shortcut:
+
+```ruby
+resources :comments do
+  get 'preview', :on => :new
+end
+```
+
+This will enable Rails to recognize paths such as `/comments/new/preview` with GET, and route to the `preview` action of `CommentsController`. It will also create the `preview_new_comment_url` and `preview_new_comment_path` route helpers.
+
 #### A Note of Caution
 
 If you find yourself adding many extra actions to a resourceful route, it's time to stop and ask yourself whether you're disguising the presence of another resource.