docs(ngRoute): clarify when gets updated

1 files changed, 4 insertions, 0 deletions

diff --git a/src/ngRoute/routeParams.js b/src/ngRoute/routeParams.js
index 0c86e89d..0007e833 100644
--- a/src/ngRoute/routeParams.js
+++ b/src/ngRoute/routeParams.js
@@ -18,6 +18,10 @@ ngRouteModule.provider('$routeParams', $RouteParamsProvider);
  * The service guarantees that the identity of the `$routeParams` object will remain unchanged
  * (but its properties will likely change) even when a route change occurs.
  *
+ * Note that the `$routeParams` are only updated *after* a route change completes successfully.
+ * This means that you cannot rely on `$routeParams` being correct in route resolve functions.
+ * Instead you can use `$route.current.params` to access the new route's parameters.
+ *
  * @example
  * <pre>
  *  // Given: