From 8e1b3f4507d71f81c46e94b9bf03786c45fc7a70 Mon Sep 17 00:00:00 2001
From: Tim van der Lippe <tvanderlippe@gmail.com>
Date: Fri, 23 Feb 2018 16:54:22 +0100
Subject: [PATCH] Fix several issues in the documentation of dom-* elements

---
 lib/elements/custom-style.html |  6 ++---
 lib/elements/dom-repeat.html   | 40 ++++++++++++++++++----------------
 2 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/lib/elements/custom-style.html b/lib/elements/custom-style.html
index 651fe94bbf..67c3f657e5 100644
--- a/lib/elements/custom-style.html
+++ b/lib/elements/custom-style.html
@@ -39,12 +39,12 @@
    *
    * For example:
    *
-   * ```
+   * ```html
    * <!-- import apply shim--only required if using mixins -->
-   * <link rel="import href="bower_components/shadycss/apply-shim.html">
+   * <link rel="import" href="bower_components/shadycss/apply-shim.html">
    * <!-- import custom-style element -->
    * <link rel="import" href="bower_components/polymer/lib/elements/custom-style.html">
-   * ...
+   *
    * <custom-style>
    *   <style>
    *     html {
diff --git a/lib/elements/dom-repeat.html b/lib/elements/dom-repeat.html
index a68e68796f..c407f61a59 100644
--- a/lib/elements/dom-repeat.html
+++ b/lib/elements/dom-repeat.html
@@ -52,28 +52,30 @@
    *
    *   </template>
    *
-   *   <script>
-   *     class EmployeeList extends Polymer.Element {
-   *       static get is() { return 'employee-list'; }
-   *       static get properties() {
-   *         return {
-   *           employees: {
-   *             value() {
-   *               return [
-   *                 {first: 'Bob', last: 'Smith'},
-   *                 {first: 'Sally', last: 'Johnson'},
-   *                 ...
-   *               ];
-   *             }
-   *           }
-   *         };
-   *       }
-   *     }
-   *   < /script>
-   *
    * </dom-module>
    * ```
    *
+   * With the following custom element definition:
+   *
+   * ```js
+   * class EmployeeList extends Polymer.Element {
+   *   static get is() { return 'employee-list'; }
+   *   static get properties() {
+   *     return {
+   *       employees: {
+   *         value() {
+   *           return [
+   *             {first: 'Bob', last: 'Smith'},
+   *             {first: 'Sally', last: 'Johnson'},
+   *             ...
+   *           ];
+   *         }
+   *       }
+   *     };
+   *   }
+   * }
+   * ```
+   *
    * Notifications for changes to items sub-properties will be forwarded to template
    * instances, which will update via the normal structured data notification system.
    *