diff --git a/lib/legacy/polymer.dom.html b/lib/legacy/polymer.dom.html
index 8e9e895850..ae9ba4bbc1 100644
--- a/lib/legacy/polymer.dom.html
+++ b/lib/legacy/polymer.dom.html
@@ -285,6 +285,8 @@
    * API.
    *
    * @namespace
+   * @summary Legacy DOM and Event manipulation API wrapper factory used to
+   * abstract differences between native Shadow DOM and "Shady DOM."
    * @memberof Polymer
    * @param {Node|Event} obj Node or event to operate on
    * @return {DomApi|EventApi} Wrapper providing either node API or event API
diff --git a/lib/mixins/element-mixin.html b/lib/mixins/element-mixin.html
index 3c8c98900a..18d63eaac5 100644
--- a/lib/mixins/element-mixin.html
+++ b/lib/mixins/element-mixin.html
@@ -732,6 +732,8 @@
    * instance counts.
    *
    * @namespace
+   * @summary Provides basic tracking of element definitions (registrations) and
+   * instance counts.
    */
   Polymer.telemetry = {
     /**