diff --git a/docs/content/guide/expression.ngdoc b/docs/content/guide/expression.ngdoc index 1650a8286021..ea2eea080433 100644 --- a/docs/content/guide/expression.ngdoc +++ b/docs/content/guide/expression.ngdoc @@ -321,3 +321,13 @@ When using a directive that takes an expression ``` +When using a filter (chain) to avoid filtering expression values over and over +again on each digest cycle. + +```html +
{{::(text | someFilter)}}
+``` + +Observe that `::(text | someFilter)` is not the same as `::text | someFilter`. The +former is unstable as long as the last filter returns undefined while the latter +is unstable as long as `text` is undefined.