aboutsummaryrefslogtreecommitdiffstats
path: root/railties/guides/source/engines.textile
diff options
context:
space:
mode:
authorPiotr Sarnacki <drogus@gmail.com>2012-03-03 21:50:08 +0100
committerPiotr Sarnacki <drogus@gmail.com>2012-03-03 21:50:08 +0100
commitb4ac72c63890e139745f32a5c642ead548e038ba (patch)
tree9e64bbb834fc578bcab69feb37c8fd624ad6f3f4 /railties/guides/source/engines.textile
parent55dd060347bbd89c21b4c0e30ba8fbf4ad792c4e (diff)
downloadrails-b4ac72c63890e139745f32a5c642ead548e038ba.tar.gz
rails-b4ac72c63890e139745f32a5c642ead548e038ba.tar.bz2
rails-b4ac72c63890e139745f32a5c642ead548e038ba.zip
[engines guide] Add more concrete example of conflicts when not using isolate_namespace
Diffstat (limited to 'railties/guides/source/engines.textile')
-rw-r--r--railties/guides/source/engines.textile2
1 files changed, 1 insertions, 1 deletions
diff --git a/railties/guides/source/engines.textile b/railties/guides/source/engines.textile
index e6058e7581..5f7eb5290c 100644
--- a/railties/guides/source/engines.textile
+++ b/railties/guides/source/engines.textile
@@ -77,7 +77,7 @@ end
By inheriting from the +Rails::Engine+ class, this gem notifies Rails that there's an engine at the specified path, and will correctly mount the engine inside the application, performing tasks such as adding the +app+ directory of the engine to the load path for models, mailers, controllers and views.
-The +isolate_namespace+ method here deserves special notice. This call is responsible for isolating the controllers, models, routes and other things into their own namespace, away from similar components inside hte application. Without this, there is a possibility that the engine's components could "leak" into the application, causing unwanted disruption, or that important engine components could be overriden by similarly named things within the application.
+The +isolate_namespace+ method here deserves special notice. This call is responsible for isolating the controllers, models, routes and other things into their own namespace, away from similar components inside hte application. Without this, there is a possibility that the engine's components could "leak" into the application, causing unwanted disruption, or that important engine components could be overriden by similarly named things within the application. One of the examples of such conflicts are helpers. Without calling +isolate_namespace+, engine's helpers would be included in application's controllers.
NOTE: It is *highly* recommended that the +isolate_namespace+ line be left within the +Engine+ class definition. Without it, classes generated in an engine *may* conflict with an application.