Explain why route shadowing should be avoided in `no-shadow-route-def…

…inition` rule doc (#1783)
ember-cli · Feb 14, 2023 · f99ee4d · f99ee4d
1 parent e0e3c48
commit f99ee4d
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/docs/rules/no-shadow-route-definition.md b/docs/rules/no-shadow-route-definition.md
@@ -8,7 +8,7 @@ Enforce no route path definition shadowing in Router.
 
 ## Rule Details
 
-This rule disallows defining shadowing route definitions.
+This rule disallows defining shadowing route definitions. Shadowing will result in the router failing to resolve the path of the shadowed route, leading to undesirable and incomprehensible behavior (e.g. hooks of the shadowed route not firing even though the URL matches its path).
 
 ## Examples