aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJon Atack <jon@atack.com>2014-12-16 11:33:50 +0100
committerJon Atack <jon@atack.com>2014-12-16 11:33:50 +0100
commit3aebff160d10770f828e485f020e1a84d8835d94 (patch)
treeb96022c726dc58256bd7777cff885c9755a984f0
parent41dc7fd650b0fcaf8f05f895aab13febac0739ec (diff)
downloadrails-3aebff160d10770f828e485f020e1a84d8835d94.tar.gz
rails-3aebff160d10770f828e485f020e1a84d8835d94.tar.bz2
rails-3aebff160d10770f828e485f020e1a84d8835d94.zip
Improve section in constant autoload guide
[skip ci]
-rw-r--r--guides/source/constant_autoloading_and_reloading.md14
1 files changed, 7 insertions, 7 deletions
diff --git a/guides/source/constant_autoloading_and_reloading.md b/guides/source/constant_autoloading_and_reloading.md
index 94546c7bb2..0f2a27f510 100644
--- a/guides/source/constant_autoloading_and_reloading.md
+++ b/guides/source/constant_autoloading_and_reloading.md
@@ -627,17 +627,17 @@ been triggered in the first place. Thus, Rails assumes a qualified reference and
considers the file `admin/user.rb` and directory `admin/user` to be the only
valid options.
-In practice this works quite well as long as the nesting matches all parent
+In practice, this works quite well as long as the nesting matches all parent
namespaces respectively and the constants that make the rule apply are known at
that time.
-But since autoloading happens on demand, if the top-level `User` by chance was
-not yet loaded then Rails has no way to know whether `Admin::User` should load it
-or raise `NameError`.
+However, autoloading happens on demand. If by chance the top-level `User` was
+not yet loaded, then Rails has no way to know whether `Admin::User` should load
+it or raise `NameError`.
-These kind of name conflicts are rare in practice but, in case there's one,
-`require_dependency` provides a solution by making sure the constant needed to
-trigger the heuristic is defined in the conflicting place.
+Naming conflicts of this kind are rare in practice, but if one occurs,
+`require_dependency` provides a solution by ensuring that the constant needed
+to trigger the heuristic is defined in the conflicting place.
### Automatic Modules