From cf786378e61760c3f7911f83ea31654986ea85f8 Mon Sep 17 00:00:00 2001
From: Zack Perdue <zack@ziggidycreative.com>
Date: Mon, 14 Apr 2014 02:33:24 -0400
Subject: Added documentation for the :param option for resourceful routing

---
 guides/source/routing.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'guides/source/routing.md')

diff --git a/guides/source/routing.md b/guides/source/routing.md
index 0783bce442..f6b1bc1509 100644
--- a/guides/source/routing.md
+++ b/guides/source/routing.md
@@ -1044,6 +1044,25 @@ end
 
 This will create routing helpers such as `magazine_periodical_ads_url` and `edit_magazine_periodical_ad_path`.
 
+### Overriding Named Route Parameters
+
+The `:param` option overrides the default resource identifier `:id` allowing you to use the specified name in your controller action to find the specific resource in the database.
+
+```ruby
+resources :videos, param: :identifier
+```
+
+```
+     videos GET  /videos(.:format)                  videos#index
+            POST /videos(.:format)                  videos#create
+ new_videos GET  /videos/new(.:format)              videos#new
+edit_videos GET  /videos/:identifier/edit(.:format) videos#edit
+```
+
+```ruby
+Video.find_by(identifier: params[:identifier])
+```
+
 Inspecting and Testing Routes
 -----------------------------
 
-- 
cgit v1.2.3