diff --git a/modules/angular2/docs/core/01_templates.md b/modules/angular2/docs/core/01_templates.md
index 3575e0efc1..5574ed65de 100644
--- a/modules/angular2/docs/core/01_templates.md
+++ b/modules/angular2/docs/core/01_templates.md
@@ -29,60 +29,74 @@ detail in the following sections.
Description
Short
Canonical
-
+
Text Interpolation
-```html
+
+```
{{exp}}
```
+
Example:
-```html
+
+```
Hello {{name}}!
Goodbye {{name}}!
```
+
`
`
Example:
-```html
+
+```
_x_
```
+
Property Interpolation
-```html
+
+```
```
+
Example:
-```html
+
+```
`
```
+
-```html
+
+```
```
+
Example:
-```html
+
+```
```
+
@@ -143,20 +157,24 @@ Example:
Example:
+
```
`
`
Example:
+
```
@@ -166,6 +184,7 @@ Example:
Example:
+
```
@@ -173,11 +192,13 @@ Example:
```
+
`...`
Example:
+
```
```
+
@@ -197,23 +219,27 @@ Example:
Example:
+
```
_some_content_to_repeat_
```
+
`...`
Example:
+
```
_some_content_to_repeat_
```
+
@@ -538,22 +564,22 @@ Angular are:
...
```
-Expressions are a simplified version of an expression in the language in which you are writing your application. (i.e.
-expressions follow JS syntax and semantics in JS and Dart syntax and semantics in Dart). Unlike expressions in the
-language, binding expressions behave differently in the following ways:
+Expressions are simplified version of expression in the language in which you are writing your application. (i.e.
+expressions follow JS syntax and semantics in JS and Dart syntax and semantics in Dart). Unlike expressions in the
+language, binding expressions behave differently in following ways:
-* *Must be defined*: Unlike Angular v1, Angular v2 will throw an error on dereferencing fields which are not defined.
- For example: `user.name` will throw an error if `user` is defined but it does not have a `name` property. If the `name`
- property is not known, it must be declared and set to some value such as an empty string, `null` (or `undefined` in JS).
- This is done to allow early detection of errors in the templates.
-* *Safe dereference*: Expression `user.name` where `user` is `null` will throw a `NullPointerException` in the language.
+* *Must be defined*: Unlike Angular v1, Angular v2 will throw an error on dereferencing fields which are not defined.
+ For example: `user.name` will throw an error if `user` is defined but it does not have `name` property. If the `name`
+ property is not known, it must be declared and set to some value such as empty string, `null` (or `undefined` in JS).
+ This is done to allow early detection of errors in the templates.
+* *Safe dereference*: Expressions `user.name` where `user` is null will throw `NullPointerException` in the language.
In contrast Angular will silently ignore `null` on `user`. This is done because Views often have to wait for the data
to arrive from the backend and many fields will be `null` until the data arrives. Safe dereference is so common in the
Views that we have made it the default.
* *Single expression*: An expression must be a single statement. (i.e. no `;`)
* *No assignments*: Binding expressions can not contain assignments.
* *No keywords*: Binding expressions can not contain keywords such as: `var`, `if`, and so on.
-* *Formatters*: Angular expressions can be piped through formatters to further transform the binding value.
+* *Formatters*: Angular expressions can be piped through formatters to further transform the binding value.
(See: Formatters)
Examples of some expressions and their behavior:
@@ -566,7 +592,7 @@ class Greeter {
```
* `name` : Will result in the value of the `name` property on the `Greeter` class.
-* `name.length`: Will result in either the length of the `name` string or `undefined` (`null` in Dart) if `name`
+* `name.length`: Will result in either the length of the `name` string or `undefined` (`null` in Dart) if `name`
property is `null` or `undefined`. Example of: safe dereference.
* `foo`: Will throw an error because `foo` is not declared on the `Greeter` class. Example of: Must be defined
* `name=1`: Not allowed because of assignment.