From 3f3313adbefb06956aafe9d90a892624b3d3ece5 Mon Sep 17 00:00:00 2001
From: Bill Heaton <bill@mediaartslab.com>
Date: Fri, 22 Jan 2016 10:31:49 -0800
Subject: [PATCH] [Documentation] willTransiting event bubbling to parent route

[Fixes #12839]
---
 packages/ember-routing/lib/system/route.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/ember-routing/lib/system/route.js b/packages/ember-routing/lib/system/route.js
index 8c80f9a7bbc..3f3b88f24a4 100644
--- a/packages/ember-routing/lib/system/route.js
+++ b/packages/ember-routing/lib/system/route.js
@@ -568,6 +568,11 @@ var Route = EmberObject.extend(ActionHandler, Evented, {
     transition, you must first explicitly call
     `transition.abort()`.
 
+    To allow the `willTransition` event to continue bubbling to the parent
+    route, use `return true;`. When the `willTransition` method has a
+    return value of `true` then the parent route's `willTransition` method
+    will be fired, enabling "bubbling" behavior for the event.
+
     @event willTransition
     @param {Transition} transition
     @public