docs(ngNonBindable): improve description

petebacondarwin · petebacondarwin · commit 977b482b0b9e · 2013-10-14T07:20:31.000+01:00
Closes angular#4391
diff --git a/src/ng/directive/ngNonBindable.js b/src/ng/directive/ngNonBindable.js
@@ -7,14 +7,16 @@
  * @priority 1000
  *
  * @description
- * Sometimes it is necessary to write code which looks like bindings but which should be left alone
- * by angular. Use `ngNonBindable` to make angular ignore a chunk of HTML.
+ * The `ngNonBindable` directive tells Angular not to compile or bind the contents of the current
+ * DOM element. This is useful if the element contains what appears to be Angular directives and
+ * bindings but which should be ignored by Angular. This could be the case if you have a site that
+ * displays snippets of code. for instance.
  *
  * @element ANY
  *
  * @example
- * In this example there are two location where a simple binding (`{{}}`) is present, but the one
- * wrapped in `ngNonBindable` is left alone.
+ * In this example there are two locations where a simple interpolation binding (`{{}}`) is present,
+ * but the one wrapped in `ngNonBindable` is left alone.
  *
  * @example
     <doc:example>

Original file line number	Diff line number	Diff line change
`@@ -7,14 +7,16 @@`
`7`	`7`	`A07F * @priority 1000`
`8`	`8`	`*`
`9`	`9`	`* @description`
`10`		`- * Sometimes it is necessary to write code which looks like bindings but which should be left alone`
`11`		- * by angular. Use `ngNonBindable` to make angular ignore a chunk of HTML.
	`10`	+ * The `ngNonBindable` directive tells Angular not to compile or bind the contents of the current
	`11`	`+ * DOM element. This is useful if the element contains what appears to be Angular directives and`
	`12`	`+ * bindings but which should be ignored by Angular. This could be the case if you have a site that`
	`13`	`+ * displays snippets of code. for instance.`
`12`	`14`	`*`
`13`	`15`	`* @element ANY`
`14`	`16`	`*`
`15`	`17`	`* @example`
`16`		- * In this example there are two location where a simple binding (`{{}}`) is present, but the one
`17`		- * wrapped in `ngNonBindable` is left alone.
	`18`	+ * In this example there are two locations where a simple interpolation binding (`{{}}`) is present,
	`19`	+ * but the one wrapped in `ngNonBindable` is left alone.
`18`	`20`	`*`
`19`	`21`	`* @example`
`20`	`22`	`<doc:example>`