From 6acebb38bc0637bc05c19d87f8767f16ce79189b Mon Sep 17 00:00:00 2001
From: Jose and Yehuda <wycats@gmail.com>
Date: Wed, 25 Apr 2012 16:06:20 -0500
Subject: Allow loading external route files from the router

This feature enables the ability to load an
external routes file from the router via:
  draw :filename

External routes files go in +config/routes+. This
feature works in both engines and applications.
---
 guides/source/routing.textile | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

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

diff --git a/guides/source/routing.textile b/guides/source/routing.textile
index 5e1cc042dc..836e0cdd70 100644
--- a/guides/source/routing.textile
+++ b/guides/source/routing.textile
@@ -829,6 +829,24 @@ end
 
 This will create routing helpers such as +magazine_periodical_ads_url+ and +edit_magazine_periodical_ad_path+.
 
+h3. Breaking Up a Large Route File
+
+If you have a large route file that you would like to break up into multiple files, you can use the +#draw+ method in your router:
+
+<ruby>
+draw :admin
+</ruby>
+
+Then, create a file called +config/routes/admin.rb+. Name the file the same as the symbol passed to the +draw+ method). You can then use the normal routing DSL inside that file:
+
+<ruby>
+# in config/routes/admin.rb
+
+namespace :admin do
+  resources :posts
+end
+</ruby>
+
 h3. Inspecting and Testing Routes
 
 Rails offers facilities for inspecting and testing your routes.
-- 
cgit v1.2.3

