diff --git a/public/resources/js/directives/live-example.js b/public/resources/js/directives/live-example.js
index 8eebff8816..6501317048 100644
--- a/public/resources/js/directives/live-example.js
+++ b/public/resources/js/directives/live-example.js
@@ -1,26 +1,46 @@
/**
* Angular.io Live Example Directive
*
-* Renders a link to a live/host example of the doc chapter
+* Renders a link to a live/host example of the doc page
* app this directive is contained in.
*
* Usage:
-* text
+* text
* Example:
*
Run Try the live example
.
-* // ~/resources/live-examples/{chapter}/ts/plnkr.html
+* // ~/resources/live-examples/{page}/ts/plnkr.html
*
* Run this example
.
-* // ~/resources/live-examples/toh-1/ts/minimal.plnkr.html
+* // ~/resources/live-examples/toh-1/ts/plnkr.html
+*
+* // Link to the default plunker in the toh-1 sample
+* // The title overrides default ("live example") with "Tour of Heroes - Part 1"
+* Run
.
+* // ~/resources/live-examples/toh-1/ts/plnkr.html
*
* Run
.
-* // ~/resources/live-examples/{chapter}/ts/minimal.plnkr.html
+* // ~/resources/live-examples/{page}/ts/minimal.plnkr.html
+*
+* // Embed the current page's default plunker
+* // Text within tag is "live example"
+* // No title (no tooltip)
+*
+* // ~/resources/live-examples/{page}/ts/eplnkr.html
*
-*
-* // ~/resources/live-examples/{chapter}/ts/eplnkr.html
+* // Links to a *new* tab as an embedded style plunker editor
+* this example
+* // ~/resources/live-examples/{page}//ts/eplnkr.html
*
-*
-* // ~/resources/live-examples/{chapter}/ts/minimal.eplnkr.html
+* // Displays in *same* tab as an embedded style plunker editor
+*