From bdfa5fcbd78ad34114111e77a06da4c8bf392520 Mon Sep 17 00:00:00 2001
From: Daniel Freedman <dfreedm@google.com>
Date: Mon, 4 Dec 2017 17:25:06 -0800
Subject: [PATCH] [skip-ci] update comment for Polymer.html

---
 lib/utils/html-fn.html | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/lib/utils/html-fn.html b/lib/utils/html-fn.html
index d8411076..72b2c824 100644
--- a/lib/utils/html-fn.html
+++ b/lib/utils/html-fn.html
@@ -25,9 +25,15 @@ subject to an additional IP rights grant found at http://polymer.github.io/PATEN
     }
 
     /**
-     * Small tagged template string function to facilitate building a `<template>` element.
-     * Polymer.html will automatically compose `<template>` elements in `${}` blocks, allowing for easy
-     * composition of superclass templates, or partial templates.
+     * A template literal tag1 that creates an HTML <template> element from the contents of the string.
+     *
+     * This allows you to write a Polymer Template in JavaScript.
+     *
+     * Interpolated values are converted to strings when the template is created,
+     * they are not intended as a replacement for Polymer data-binding.
+     *
+     * There is special support for HTMLTemplateElement values,
+     * allowing for easy composition of superclass or partial templates.
      *
      * Example:
      *