docs: update jsdocs for the activate method

Author: matt-sneed

lib/route-tree-node.js

@@ -220,14 +220,23 @@ class RouteTreeNode {
 
   /**
    * Cause this route to become the active route. When a route is activated,
-   * exitCallback functions from the routeData should be called up the tree in order
+   * routeExit functions from the routeData should be called up the tree in order
    * beginning with the previousNodeId until a common node is found with the
    * path from the root to this node.
    *
-   * After exitCallback methods have all completed, entryCallbacks should
+   * After routeExit methods have all completed, beforeEntry and routeEnter callbacks should
    * be called in order beginning with the root node down the tree through
    * this node.
    *
+   * Route lifecycle methods (`routeExit`, `beforeEnter`, `routeEnter`) can be defined
+   * in the `routeData` object and/or on the associated `routingElement` (if it
+   * implements `BasicRoutingInterface`). Both implementations, if they exist,
+   * will be called for the respective phase. For entry hooks, `beforeEnter`
+   * is called first, and if either the `routeData`'s or element's `beforeEnter`
+   * returns `false`, the activation process will stop at the current and subsequent nodes. If
+   * `routeEnter` returns `false`, subsequent `routeEnter` calls down the tree
+   * are skipped. The `routingElement` is expected to implement `routeExit` and `routeEnter`.
+   *
    *      _Root_
    *     /      \
    *    A       D
@@ -237,13 +246,13 @@ class RouteTreeNode {
    * If the current route is "B" and the route for "E" is activated,
    * then the following callbacks should be invoked:
    *
-   *     B.exitCallback, A.exitCallback, Root.entryCallback,
-   *     D.entryCallback, E.entryCallback
+   *     B.routeExit, A.routeExit, Root.beforeEnter, Root.routeEnter,
+   *     D.beforeEnter, D.routeEnter, E.beforeEnter, E.routeEnter
    *
    * If the current route is "B" and the route for "C" is activated,
    * then the following callbacks should be invoked:
    *
-   *     B.exitCallback, Root.entryCallback, A.entryCallback, C.entryCallback
+   *     B.routeExit, Root.beforeEnter, Root.routeEnter, A.beforeEnter, A.routeEnter, C.beforeEnter, C.routeEnter
    *
    * @param {!string|undefined} previousRouteId
    * @param {!Context} context