'use strict';

/**
 * @ngdoc directive
 * @name ng.directive:ngNonBindable
 * @restrict AC
 * @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.
 *
 * @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.
 *
 * @example
    <doc:example>
      <doc:source>
        <div>Normal: {{1 + 2}}</div>
        <div ng-non-bindable>Ignored: {{1 + 2}}</div>
      </doc:source>
      <doc:scenario>
       it('should check ng-non-bindable', function() {
         expect(using('.doc-example-live').binding('1 + 2')).toBe('3');
         expect(using('.doc-example-live').element('div:last').text()).
           toMatch(/1 \+ 2/);
       });
      </doc:scenario>
    </doc:example>
 */
var ngNonBindableDirective = ngDirective({ terminal: true, priority: 1000 });

@@ -128,64 +128,202 @@
 %0A * 
-Sometimes it is necessary to write code which looks like
+The %60ngNonBindable%60 directive tells Angular not to compile or bind the contents of the current%0A * DOM element. This is useful if the element contains what appears to be Angular directives and%0A *
  bin
@@ -352,34 +352,28 @@
  be 
-left alone%0A *
+ignored
  by 
-a
+A
 ngular. 
 Use 
@@ -372,66 +372,97 @@
 ar. 
-Use %60ngNonBindable%60 to make angular ignore a chunk of HTML
+This could be the case if you have a site that%0A * displays snippets of code. for instance
 .%0A *
@@ -534,16 +534,17 @@
 location
+s
  where a
@@ -551,16 +551,30 @@
  simple 
+interpolation 
 binding 
@@ -593,16 +593,19 @@
 present,
+%0A *
  but the
@@ -608,19 +608,16 @@
  the one
-%0A *
  wrapped

improve description