Sync docs from 2.2.x to gh-pages

2020-04-23 05:11:09 +00:00
parent f55939bd1b
commit 8e6e771e11
10 changed files with 374 additions and 116 deletions
--- a/2.2.x/reference/html/css/spring.css
+++ b/2.2.x/reference/html/css/spring.css
--- a/2.2.x/reference/html/index.html
+++ b/2.2.x/reference/html/index.html
@@ -1602,26 +1602,17 @@ Span nextSpan(final Request input) {
 <div class="sect2">
 <h3 id="sampling-in-spring-cloud-sleuth"><a class="anchor" href="#sampling-in-spring-cloud-sleuth"></a><a class="link" href="#sampling-in-spring-cloud-sleuth">4.3. Sampling in Spring Cloud Sleuth</a></h3>
 <div class="paragraph">
-<p>By default Spring Cloud Sleuth sets all spans to non-exportable.
-That means that traces appear in logs but not in any remote store.
-For testing the default is often enough, and it probably is all you need if you use only the logs (for example, with an ELK aggregator).
-If you export span data to Zipkin, there is also an <code>Sampler.ALWAYS_SAMPLE</code> setting that exports everything, <code>RateLimitingSampler</code> setting that samples X transactions per second (defaults to <code>1000</code>) or <code>ProbabilityBasedSampler</code> setting that samples a fixed fraction of spans.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-The <code>RateLimitingSampler</code> is the default if you use <code>spring-cloud-sleuth-zipkin</code>.
-You can configure the rate limit by setting <code>spring.sleuth.sampler.rate</code>.
-</td>
-</tr>
-</table>
+<p>Sampling only applies to tracing backends, such as Zipkin. Trace IDs appear in logs regardless of
+sample rate. Sampling is a way to prevent overloading the system, by consistently tracing some, but
+not all requests.</p>
 </div>
 <div class="paragraph">
-<p>A sampler can be installed by creating a bean definition, as shown in the following example:</p>
+<p>The default rate of 10 traces per second is controlled by the <code>spring.sleuth.sampler.rate</code>
+property and applies when we know Sleuth is used for reasons besides logging. Use a rate above 100
+traces per second with extreme caution as it can overload your tracing system.</p>
+</div>
+<div class="paragraph">
+<p>The sampler can be set by Java Config also, as shown in the following example:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -1639,14 +1630,11 @@ public Sampler defaultSampler() {
 </td>
 <td class="content">
 You can set the HTTP header <code>X-B3-Flags</code> to <code>1</code>, or, when doing messaging, you can set the <code>spanFlags</code> header to <code>1</code>.
-Doing so forces the current span to be exportable regardless of the sampling decision.
+Doing so forces the corresponding trace to be sampled regardless of the sampling configuration.
 </td>
 </tr>
 </table>
 </div>
-<div class="paragraph">
-<p>In order to use the rate-limited sampler set the <code>spring.sleuth.sampler.rate</code> property to choose an amount of traces to accept on a per-second interval. The minimum number is 0 and the max is 2,147,483,647 (max int).</p>
-</div>
 </div>
 </div>
 </div>
--- a/2.2.x/reference/html/js/highlight/styles/github-gist.css
+++ b/2.2.x/reference/html/js/highlight/styles/github-gist.css
@@ -0,0 +1,79 @@
+/**
+ * GitHub Gist Theme
+ * Author : Anthony Attard - https://github.com/AnthonyAttard
+ * Author : Louis Barranqueiro - https://github.com/LouisBarranqueiro
+ */
+
+.hljs {
+    display: block;
+    background: white;
+    padding: 0.5em;
+    color: #333333;
+    overflow-x: auto;
+}
+
+.hljs-comment,
+.hljs-meta {
+    color: #969896;
+}
+
+.hljs-variable,
+.hljs-template-variable,
+.hljs-strong,
+.hljs-emphasis,
+.hljs-quote {
+    color: #df5000;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-type {
+    color: #d73a49;
+}
+
+.hljs-literal,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-attribute {
+    color: #0086b3;
+}
+
+.hljs-section,
+.hljs-name {
+    color: #63a35c;
+}
+
+.hljs-tag {
+    color: #333333;
+}
+
+.hljs-title,
+.hljs-attr,
+.hljs-selector-id,
+.hljs-selector-class,
+.hljs-selector-attr,
+.hljs-selector-pseudo {
+    color: #6f42c1;
+}
+
+.hljs-addition {
+    color: #55a532;
+    background-color: #eaffea;
+}
+
+.hljs-deletion {
+    color: #bd2c00;
+    background-color: #ffecec;
+}
+
+.hljs-link {
+    text-decoration: underline;
+}
+
+.hljs-number {
+    color: #005cc5;
+}
+
+.hljs-string {
+    color: #032f62;
+}
--- a/2.2.x/reference/html/js/highlight/styles/googlecode.css
+++ b/2.2.x/reference/html/js/highlight/styles/googlecode.css
@@ -0,0 +1,89 @@
+/*
+
+Google Code style (c) Aahan Krish <geekpanth3r@gmail.com>
+
+*/
+
+.hljs {
+    display: block;
+    overflow-x: auto;
+    padding: 0.5em;
+    background: white;
+    color: black;
+}
+
+.hljs-comment,
+.hljs-quote {
+    color: #800;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-section,
+.hljs-title,
+.hljs-name {
+    color: #008;
+}
+
+.hljs-variable,
+.hljs-template-variable {
+    color: #660;
+}
+
+.hljs-string,
+.hljs-selector-attr,
+.hljs-selector-pseudo,
+.hljs-regexp {
+    color: #080;
+}
+
+.hljs-literal,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-meta,
+.hljs-number,
+.hljs-link {
+    color: #066;
+}
+
+.hljs-title,
+.hljs-doctag,
+.hljs-type,
+.hljs-attr,
+.hljs-built_in,
+.hljs-builtin-name,
+.hljs-params {
+    color: #606;
+}
+
+.hljs-attribute,
+.hljs-subst {
+    color: #000;
+}
+
+.hljs-formula {
+    background-color: #eee;
+    font-style: italic;
+}
+
+.hljs-selector-id,
+.hljs-selector-class {
+    color: #9B703F
+}
+
+.hljs-addition {
+    background-color: #baeeba;
+}
+
+.hljs-deletion {
+    background-color: #ffc8bd;
+}
+
+.hljs-doctag,
+.hljs-strong {
+    font-weight: bold;
+}
+
+.hljs-emphasis {
+    font-style: italic;
+}
--- a/2.2.x/reference/html/js/toc.js
+++ b/2.2.x/reference/html/js/toc.js
@@ -16,7 +16,13 @@ if (toctitle != null) {
    });
    if (!path.endsWith("index.html") && !path.endsWith("/")) {
        var link = document.createElement("a");
-        link.setAttribute("href", "index.html");
+        if (document.getElementById('index-link')) {
+          indexLinkElement = document.querySelector('#index-link > p > a');
+          linkHref = indexLinkElement.getAttribute("href");
+          link.setAttribute("href", linkHref);
+        } else {
+          link.setAttribute("href", "index.html");
+        }
        link.innerHTML = "<span><i class=\"fa fa-chevron-left\" aria-hidden=\"true\"></i></span> Back to index";
        var block = document.createElement("div");
        block.setAttribute('class', 'back-action');
@@ -63,39 +69,6 @@ var headerHtml = '<div id="header-spring">\n' +
    'C113.4,3.9,114.5,4.9,114.5,6.3z"/>\n' +
    '</g>\n' +
    '</g>\n' +
-    '<g class="st1">\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M200.1,21.1H198V19h2.1V21.1z M200.1,32.9H198V22.6h2.1V32.9z"/>\n' +
-    '</g>\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M212.5,22.6l-3,8.9c-0.5,1.5-1.4,1.6-2.2,1.6c-1.1,0-1.8-0.5-2.2-1.6l-2.5-7.4h-1v-1.5h2.6l2.6,8.3\n' +
-    'c0.1,0.4,0.2,0.6,0.5,0.6c0.3,0,0.4-0.2,0.5-0.6l2.6-8.3H212.5z"/>\n' +
-    '<path class="st2" d="M217.8,22.6c2.8,0,4.7,1.8,4.7,4.5v1.6c0,2.6-1.9,4.5-4.7,4.5c-2.8,0-4.7-1.8-4.7-4.5v-1.6\n' +
-    'C213,24.4,215,22.6,217.8,22.6 M217.8,31.4c1.7,0,2.7-1.3,2.7-2.8v-1.6c0-1.5-1-2.8-2.7-2.8c-1.8,0-2.7,1.3-2.7,2.8v1.6\n' +
-    'C215.1,30.2,216,31.4,217.8,31.4"/>\n' +
-    '<path class="st2" d="M239.6,22.9c-1.1-0.3-2.7-0.5-4-0.5c-2.8,0-4.6,1.8-4.6,4.6v1.1c0,2.9,1.7,4.7,4.6,4.7c0.1,0,0.6,0,0.8,0\n' +
-    'v-1.7c-0.1,0-0.7,0-0.8,0c-1.5,0-2.6-1.2-2.6-2.9v-1.1c0-1.8,1-2.9,2.6-2.9c0.7,0,1.7,0.1,2.1,0.1l0.1,0l0,8.6h2.1v-9.6\n' +
-    'C240,23.1,240,23,239.6,22.9"/>\n' +
-    '<rect x="242.1" y="19" class="st2" width="2.1" height="13.9"/>\n' +
-    '<path class="st2" d="M190.5,19h-3.8v13.9h2.2V20.9h1.3c0.3,0,0.5,0,0.8,0c1.9,0,2.9,0.8,2.9,2.3c0,0.1,0,0.1,0,0.2\n' +
-    'c0,1.4-0.8,2.3-2.9,2.3c-0.2,0-0.4,0-0.6,0c0,0.5,0,1.5,0,1.9c0.2,0,0.4,0,0.6,0c3,0,5.2-1.2,5.2-4.2c0-0.1,0-0.1,0-0.2\n' +
-    'C196.2,20.2,193.9,19,190.5,19"/>\n' +
-    '<path class="st2" d="M226.3,20.4v2.2h3.5v1.7h-3.5v6c0,0.9,0.6,1,1.5,1h2v1.7H227c-2,0-2.9-0.8-2.9-2.6v-9.6L226.3,20.4z"/>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M167.7,32.9v-10h1.1v3.8c0.6-0.8,1.5-1.3,2.4-1.3c1.9,0,3.2,1.5,3.2,3.8c0,2.4-1.3,3.8-3.2,3.8\n' +
-    'c-1,0-1.9-0.5-2.4-1.3v1.1H167.7z M171,32.1c1.5,0,2.3-1.2,2.3-2.8c0-1.6-0.9-2.8-2.3-2.8c-0.9,0-1.8,0.5-2.2,1.2v3.3\n' +
-    'C169.2,31.6,170.1,32.1,171,32.1z"/>\n' +
-    '<path class="st2" d="M175.9,34.7c0.2,0.1,0.4,0.1,0.6,0.1c0.5,0,0.8-0.2,1.1-0.8l0.5-1.1l-3-7.3h1.2l2.4,5.9l2.4-5.9h1.2\n' +
-    'l-3.6,8.7c-0.4,1-1.2,1.5-2.1,1.5c-0.2,0-0.6,0-0.8-0.1L175.9,34.7z"/>\n' +
-    '</g>\n' +
-    '</g>\n' +
    '</g>\n' +
    '</svg>\n' +
    '\n' +
@@ -104,4 +77,4 @@ var headerHtml = '<div id="header-spring">\n' +

 var header = document.createElement("div");
 header.innerHTML = headerHtml;
-document.body.insertBefore(header, document.body.firstChild);
+document.body.insertBefore(header, document.body.firstChild);
--- a/2.2.x/reference/html/spring-cloud-sleuth.html
+++ b/2.2.x/reference/html/spring-cloud-sleuth.html
@@ -1602,26 +1602,17 @@ Span nextSpan(final Request input) {
 <div class="sect2">
 <h3 id="sampling-in-spring-cloud-sleuth"><a class="anchor" href="#sampling-in-spring-cloud-sleuth"></a><a class="link" href="#sampling-in-spring-cloud-sleuth">4.3. Sampling in Spring Cloud Sleuth</a></h3>
 <div class="paragraph">
-<p>By default Spring Cloud Sleuth sets all spans to non-exportable.
-That means that traces appear in logs but not in any remote store.
-For testing the default is often enough, and it probably is all you need if you use only the logs (for example, with an ELK aggregator).
-If you export span data to Zipkin, there is also an <code>Sampler.ALWAYS_SAMPLE</code> setting that exports everything, <code>RateLimitingSampler</code> setting that samples X transactions per second (defaults to <code>1000</code>) or <code>ProbabilityBasedSampler</code> setting that samples a fixed fraction of spans.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-note" title="Note"></i>
-</td>
-<td class="content">
-The <code>RateLimitingSampler</code> is the default if you use <code>spring-cloud-sleuth-zipkin</code>.
-You can configure the rate limit by setting <code>spring.sleuth.sampler.rate</code>.
-</td>
-</tr>
-</table>
+<p>Sampling only applies to tracing backends, such as Zipkin. Trace IDs appear in logs regardless of
+sample rate. Sampling is a way to prevent overloading the system, by consistently tracing some, but
+not all requests.</p>
 </div>
 <div class="paragraph">
-<p>A sampler can be installed by creating a bean definition, as shown in the following example:</p>
+<p>The default rate of 10 traces per second is controlled by the <code>spring.sleuth.sampler.rate</code>
+property and applies when we know Sleuth is used for reasons besides logging. Use a rate above 100
+traces per second with extreme caution as it can overload your tracing system.</p>
+</div>
+<div class="paragraph">
+<p>The sampler can be set by Java Config also, as shown in the following example:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -1639,14 +1630,11 @@ public Sampler defaultSampler() {
 </td>
 <td class="content">
 You can set the HTTP header <code>X-B3-Flags</code> to <code>1</code>, or, when doing messaging, you can set the <code>spanFlags</code> header to <code>1</code>.
-Doing so forces the current span to be exportable regardless of the sampling decision.
+Doing so forces the corresponding trace to be sampled regardless of the sampling configuration.
 </td>
 </tr>
 </table>
 </div>
-<div class="paragraph">
-<p>In order to use the rate-limited sampler set the <code>spring.sleuth.sampler.rate</code> property to choose an amount of traces to accept on a per-second interval. The minimum number is 0 and the max is 2,147,483,647 (max int).</p>
-</div>
 </div>
 </div>
 </div>
--- a/2.2.x/reference/htmlsingle/css/spring.css
+++ b/2.2.x/reference/htmlsingle/css/spring.css
--- a/2.2.x/reference/htmlsingle/js/highlight/styles/github-gist.css
+++ b/2.2.x/reference/htmlsingle/js/highlight/styles/github-gist.css
@@ -0,0 +1,79 @@
+/**
+ * GitHub Gist Theme
+ * Author : Anthony Attard - https://github.com/AnthonyAttard
+ * Author : Louis Barranqueiro - https://github.com/LouisBarranqueiro
+ */
+
+.hljs {
+    display: block;
+    background: white;
+    padding: 0.5em;
+    color: #333333;
+    overflow-x: auto;
+}
+
+.hljs-comment,
+.hljs-meta {
+    color: #969896;
+}
+
+.hljs-variable,
+.hljs-template-variable,
+.hljs-strong,
+.hljs-emphasis,
+.hljs-quote {
+    color: #df5000;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-type {
+    color: #d73a49;
+}
+
+.hljs-literal,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-attribute {
+    color: #0086b3;
+}
+
+.hljs-section,
+.hljs-name {
+    color: #63a35c;
+}
+
+.hljs-tag {
+    color: #333333;
+}
+
+.hljs-title,
+.hljs-attr,
+.hljs-selector-id,
+.hljs-selector-class,
+.hljs-selector-attr,
+.hljs-selector-pseudo {
+    color: #6f42c1;
+}
+
+.hljs-addition {
+    color: #55a532;
+    background-color: #eaffea;
+}
+
+.hljs-deletion {
+    color: #bd2c00;
+    background-color: #ffecec;
+}
+
+.hljs-link {
+    text-decoration: underline;
+}
+
+.hljs-number {
+    color: #005cc5;
+}
+
+.hljs-string {
+    color: #032f62;
+}
--- a/2.2.x/reference/htmlsingle/js/highlight/styles/googlecode.css
+++ b/2.2.x/reference/htmlsingle/js/highlight/styles/googlecode.css
@@ -0,0 +1,89 @@
+/*
+
+Google Code style (c) Aahan Krish <geekpanth3r@gmail.com>
+
+*/
+
+.hljs {
+    display: block;
+    overflow-x: auto;
+    padding: 0.5em;
+    background: white;
+    color: black;
+}
+
+.hljs-comment,
+.hljs-quote {
+    color: #800;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-section,
+.hljs-title,
+.hljs-name {
+    color: #008;
+}
+
+.hljs-variable,
+.hljs-template-variable {
+    color: #660;
+}
+
+.hljs-string,
+.hljs-selector-attr,
+.hljs-selector-pseudo,
+.hljs-regexp {
+    color: #080;
+}
+
+.hljs-literal,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-meta,
+.hljs-number,
+.hljs-link {
+    color: #066;
+}
+
+.hljs-title,
+.hljs-doctag,
+.hljs-type,
+.hljs-attr,
+.hljs-built_in,
+.hljs-builtin-name,
+.hljs-params {
+    color: #606;
+}
+
+.hljs-attribute,
+.hljs-subst {
+    color: #000;
+}
+
+.hljs-formula {
+    background-color: #eee;
+    font-style: italic;
+}
+
+.hljs-selector-id,
+.hljs-selector-class {
+    color: #9B703F
+}
+
+.hljs-addition {
+    background-color: #baeeba;
+}
+
+.hljs-deletion {
+    background-color: #ffc8bd;
+}
+
+.hljs-doctag,
+.hljs-strong {
+    font-weight: bold;
+}
+
+.hljs-emphasis {
+    font-style: italic;
+}
--- a/2.2.x/reference/htmlsingle/js/toc.js
+++ b/2.2.x/reference/htmlsingle/js/toc.js
@@ -16,7 +16,13 @@ if (toctitle != null) {
    });
    if (!path.endsWith("index.html") && !path.endsWith("/")) {
        var link = document.createElement("a");
-        link.setAttribute("href", "index.html");
+        if (document.getElementById('index-link')) {
+          indexLinkElement = document.querySelector('#index-link > p > a');
+          linkHref = indexLinkElement.getAttribute("href");
+          link.setAttribute("href", linkHref);
+        } else {
+          link.setAttribute("href", "index.html");
+        }
        link.innerHTML = "<span><i class=\"fa fa-chevron-left\" aria-hidden=\"true\"></i></span> Back to index";
        var block = document.createElement("div");
        block.setAttribute('class', 'back-action');
@@ -63,39 +69,6 @@ var headerHtml = '<div id="header-spring">\n' +
    'C113.4,3.9,114.5,4.9,114.5,6.3z"/>\n' +
    '</g>\n' +
    '</g>\n' +
-    '<g class="st1">\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M200.1,21.1H198V19h2.1V21.1z M200.1,32.9H198V22.6h2.1V32.9z"/>\n' +
-    '</g>\n' +
-    '<g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M212.5,22.6l-3,8.9c-0.5,1.5-1.4,1.6-2.2,1.6c-1.1,0-1.8-0.5-2.2-1.6l-2.5-7.4h-1v-1.5h2.6l2.6,8.3\n' +
-    'c0.1,0.4,0.2,0.6,0.5,0.6c0.3,0,0.4-0.2,0.5-0.6l2.6-8.3H212.5z"/>\n' +
-    '<path class="st2" d="M217.8,22.6c2.8,0,4.7,1.8,4.7,4.5v1.6c0,2.6-1.9,4.5-4.7,4.5c-2.8,0-4.7-1.8-4.7-4.5v-1.6\n' +
-    'C213,24.4,215,22.6,217.8,22.6 M217.8,31.4c1.7,0,2.7-1.3,2.7-2.8v-1.6c0-1.5-1-2.8-2.7-2.8c-1.8,0-2.7,1.3-2.7,2.8v1.6\n' +
-    'C215.1,30.2,216,31.4,217.8,31.4"/>\n' +
-    '<path class="st2" d="M239.6,22.9c-1.1-0.3-2.7-0.5-4-0.5c-2.8,0-4.6,1.8-4.6,4.6v1.1c0,2.9,1.7,4.7,4.6,4.7c0.1,0,0.6,0,0.8,0\n' +
-    'v-1.7c-0.1,0-0.7,0-0.8,0c-1.5,0-2.6-1.2-2.6-2.9v-1.1c0-1.8,1-2.9,2.6-2.9c0.7,0,1.7,0.1,2.1,0.1l0.1,0l0,8.6h2.1v-9.6\n' +
-    'C240,23.1,240,23,239.6,22.9"/>\n' +
-    '<rect x="242.1" y="19" class="st2" width="2.1" height="13.9"/>\n' +
-    '<path class="st2" d="M190.5,19h-3.8v13.9h2.2V20.9h1.3c0.3,0,0.5,0,0.8,0c1.9,0,2.9,0.8,2.9,2.3c0,0.1,0,0.1,0,0.2\n' +
-    'c0,1.4-0.8,2.3-2.9,2.3c-0.2,0-0.4,0-0.6,0c0,0.5,0,1.5,0,1.9c0.2,0,0.4,0,0.6,0c3,0,5.2-1.2,5.2-4.2c0-0.1,0-0.1,0-0.2\n' +
-    'C196.2,20.2,193.9,19,190.5,19"/>\n' +
-    '<path class="st2" d="M226.3,20.4v2.2h3.5v1.7h-3.5v6c0,0.9,0.6,1,1.5,1h2v1.7H227c-2,0-2.9-0.8-2.9-2.6v-9.6L226.3,20.4z"/>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '</g>\n' +
-    '<g>\n' +
-    '<path class="st2" d="M167.7,32.9v-10h1.1v3.8c0.6-0.8,1.5-1.3,2.4-1.3c1.9,0,3.2,1.5,3.2,3.8c0,2.4-1.3,3.8-3.2,3.8\n' +
-    'c-1,0-1.9-0.5-2.4-1.3v1.1H167.7z M171,32.1c1.5,0,2.3-1.2,2.3-2.8c0-1.6-0.9-2.8-2.3-2.8c-0.9,0-1.8,0.5-2.2,1.2v3.3\n' +
-    'C169.2,31.6,170.1,32.1,171,32.1z"/>\n' +
-    '<path class="st2" d="M175.9,34.7c0.2,0.1,0.4,0.1,0.6,0.1c0.5,0,0.8-0.2,1.1-0.8l0.5-1.1l-3-7.3h1.2l2.4,5.9l2.4-5.9h1.2\n' +
-    'l-3.6,8.7c-0.4,1-1.2,1.5-2.1,1.5c-0.2,0-0.6,0-0.8-0.1L175.9,34.7z"/>\n' +
-    '</g>\n' +
-    '</g>\n' +
    '</g>\n' +
    '</svg>\n' +
    '\n' +
@@ -104,4 +77,4 @@ var headerHtml = '<div id="header-spring">\n' +

 var header = document.createElement("div");
 header.innerHTML = headerHtml;
-document.body.insertBefore(header, document.body.firstChild);
+document.body.insertBefore(header, document.body.firstChild);