docs(*): misc fixes to prose in support of jade2ng (#2266)

Fixes to prose “syntax”. Anomalies detected by jade2ng.
Also updated the main _utils-fn.jade in support of jade2ng as well.

public/_includes/_util-fns.jade

@@ -154,7 +154,8 @@ mixin makeJson( filePath, jsonConfig, title, stylePatterns)
     else
       != styleString(jsonExtract, stylePatterns)
 
-- // Open (and close) an explanation <div>. See QuickStart
+if !jade2ng
+  //- Open (and close) an explanation <div>. See QuickStart
   script.
     function why(id, backTo) {
       var id = "#"+id;
@@ -212,6 +213,7 @@ script.
       else
         return CCSstyle[style] = value
     }
+
 //---------------------------------------------------------------------------------------------------------
 //- Converts the given project-relative path (like 'app/main.ts')
 //- to a doc folder relative path (like 'quickstart/ts/app/main.ts')
@@ -298,7 +300,7 @@ script.
 -   } else {
 -     // ``` gets translated to <pre><code>.....</code></pre> and we need
 -     // to remove this from the fragment prefix is 11 long and suffix is 13 long
--     frag = frag.substring(11, frag.length-13);
+-     frag = jade2ng ? frag : frag.substring(11, frag.length-13);
 -     // Uncomment next line for debugging.
 -     // frag = "FileName: " + fullFileName + "   Current path: " + current.path +  " PathToDocs: " + getPathToDocs() + "\n" + frag;
 -     return frag;

public/docs/ts/latest/cookbook/component-communication.jade

@@ -172,9 +172,7 @@ figure.image-display
 :marked
   [Back to top](#top)
 
-parent-to-child-local-var
-.l-main-section
-<a id="parent-to-child-local-var"></a>
+.l-main-section#parent-to-child-local-var
 :marked
   ## Parent interacts with child via *local variable*
   

public/docs/ts/latest/cookbook/visual-studio-2015.jade

@@ -139,7 +139,7 @@ h2#build-and-run Step 7: Build and run the app
   
 .alert.is-important
   :marked
-    Compiler errors such as "*Property ‘map’ does not exist on type ‘Observable<Response>’*" and
+    Compiler errors such as "*Property `map` does not exist on type `Observable<Response>`*" and
     "*Observable cannot be found*" indicate an old release of Visual Studio.
     Exit Visual Studio and follow the [instructions here](https://github.com/Microsoft/TypeScript/issues/8518).
 

public/docs/ts/latest/guide/server-communication.jade

@@ -246,7 +246,7 @@ a#HeroService
   :marked
     Let's return to our study of the `HeroService`.
     
-l-main-section
+.l-main-section
 a#extract-data
 :marked
   ## Process the response object
@@ -410,7 +410,7 @@ block hero-list-comp-add-hero
   h2#promises Fall back to Promises
   :marked
     Although the Angular `http` client API returns an `Observable<Response>` we can turn it into a 
-    [Promise<Response>](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) if we prefer.
+    [`Promise<Response>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) if we prefer.
     It's easy to do and a promise-based version looks much like the observable-based version in simple cases.
   .l-sub-section
     :marked

public/docs/ts/latest/guide/webpack.jade

@@ -431,7 +431,7 @@ code-example(format="").
 p.
   The <code>app.component.html</code> displays this downloadable Angular logo
   <a href="https://raw.githubusercontent.com/angular/angular.io/master/public/resources/images/logos/angular2/angular.png" target="_blank">
-  <img src="https://raw.githubusercontent.com/angular/angular.io/master/public/resources/images/logos/angular2/angular.png" height="40px" title="download Angular logo"></a>.
+  <img src="/resources/images/logos/angular2/angular.png" height="40px" title="download Angular logo"></a>.
 
 
 +makeTabs(

public/docs/ts/latest/quickstart.jade

@@ -26,7 +26,7 @@ h1 Overview
 
 aside.is-right
   :marked
-    The live example link opens the finished application <span if-docs="ts"> in
+    The live example link opens the finished application in
     <a href="http://plnkr.co/" title="Plunker" target="_blank">Plunker</a> so that you can interact
     with the code. You'll find live examples at the start of most sections.
 
@@ -48,7 +48,7 @@ h2 Build this application!
 :marked
   - [Prerequisite](#prereq): Install #{_prereq}.
   - [Step 1](#create-and-configure): Create and configure the project.
-  <li if-docs="ts">[Step 2](#ngmodule): Create your application.</li>
+  <span if-docs="ts"><li>[Step 2](#ngmodule): Create your application.</span>
   - [Step !{step++}](#root-component): Create a component and add it to your application.
   - [Step !{step++}](#main): Start up your application.
   - [Step !{step++}](#index): Define the web page that hosts the application.