add consumer table

Author: filipesilva

public/docs/ts/latest/cookbook/third-party-lib.jade

@@ -28,6 +28,8 @@ include ../_util-fns
 
   [Library package format](#library-package-format)
 
+  [Published file layout](#published-file-layout)
+
   [Setup a local development environment](#setup-a-local-development-environment)
 
   [What's in the QuickStart Library seed?](#what-s-in-the-quickstart-library-seed-)
@@ -57,7 +59,8 @@ include ../_util-fns
   or the native Node one.
   Bundlers, like [Webpack](https://webpack.js.org/) are very popular as well.
   [Typescript](typescriptlang.org) users need type definitions.
-  [Rollup](https://github.com/rollup/rollup) users make use of ECMAScript modules for tree-shaking.
+  [Rollup](https://github.com/rollup/rollup) users make use of ECMAScript Modules (ESM)
+  for tree-shaking.
   Even though [Ahead-of-time](#appendix-supporting-aot) is preferred, 
   [Just-in-time](#appendix-supporting-jit) compilation should be supported.
 
@@ -69,13 +72,73 @@ include ../_util-fns
   The recommended set of entry points is as follows:
 
   - `main` (default): an ES5 [UMD](https://github.com/umdjs/umd) bundle that can be consumed anywhere.
-  - `module`: a flat ECMAScript module (FESM) bundle containing ES5 code.
-  - `es2015`: a FESM containing ES2015 bundle.
+  - `module`: a flat ECMAScript Module (ESM) bundle containing ES5 code.
+  - `es2015`: a flat ESM containing ES2015 bundle.
   - `typings`: TypeScript and the AOT compiler will look at this entry for metadata.
 
   In addition, a minimized version of the UMD bundle should also be provided, as well as full
   sourcemaps (all the way back to the source) for all JS bundles.
 
+  This set of entry points satisfies the following consumers:
+
+style td, th {vertical-align: top}
+table(width="100%")
+  col(width="40%")
+  col(width="20%")
+  col(width="40%")
+  tr
+    th Consumer
+    th Module format
+    th Entry point resolves to
+  tr
+    td Webpack (es2015) / Closure Compiler
+    td ESM+ES2015
+    td
+      :marked 
+        `angular-library-name.js`
+  tr
+    td Angular CLI / Webpack/ Rollup
+    td ESM+ES5
+    td
+      :marked 
+        `angular-library-name.es5.js`
+  tr
+    td Plunker / Fiddle / ES5 / script tag
+    td UMD
+    td
+      :marked 
+        Requires manual resolution to `bundles/angular-library-name.umd.js`/`bundles/angular-library-name.umd.min.js`
+  tr
+    td Node.js
+    td UMD
+    td
+      :marked 
+        `bundles/angular-library-name.umd.js`
+  tr
+    td TypeScript
+    td ESM+*.d.ts
+    td
+      :marked 
+        `angular-library-name.d.ts`
+  tr
+    td AOT compilation
+    td *.metadata.json
+    td
+      :marked 
+        `angular-library-name.metadata.json`
+
+.l-sub-section
+  :marked
+    A flat ECMAScript module (FESM) is a bundled ECMAScript module where all imports were followed 
+    copied onto the same file file.
+    It always contains ES module import/export statements but can have different levels of ES code
+    inside.
+      
+
+.l-main-section
+:marked
+  ## Published file layout
+
   A library should have the following file layout when published:
 
 .filetree
@@ -100,19 +163,6 @@ include ../_util-fns
   .file README.md
 
 
-:marked
-  There is also a minified UMD bundle (`angular-quickstart-lib.umd.min.js`) for smaller payloads
-  in Plunkers and script tags.
-
-
-.l-sub-section
-  :marked
-    A flat ECMAScript module (FESM) is a bundled ECMAScript module where all imports were followed 
-    copied onto the same file file.
-    It always contains ES module import/export statements but can have different levels of ES code
-    inside.
-
-
 .l-main-section
 :marked
   ## The QuickStart Library seed