Switch site to using normal font weight throughout for better readability.

Also, turn off one of the HTML compression options. It went a bit too far and caused
rendering to be altered in some pages.

Gemfile.lock

@@ -70,7 +70,7 @@ GEM
       octokit (~> 4.0)
       public_suffix (~> 2.0)
       typhoeus (~> 0.7)
-    html-pipeline (2.5.0)
+    html-pipeline (2.6.0)
       activesupport (>= 2)
       nokogiri (>= 1.4)
     html-proofer (3.6.0)
@@ -180,7 +180,7 @@ GEM
       mini_portile2 (~> 2.1.0)
     octokit (4.7.0)
       sawyer (~> 0.8.0, >= 0.5.3)
-    parallel (1.11.2)
+    parallel (1.11.1)
     pathutil (0.14.0)
       forwardable-extended (~> 2.6)
     public_suffix (2.0.5)
@@ -189,18 +189,18 @@ GEM
       ffi (>= 0.5.0)
     rouge (1.11.1)
     safe_yaml (1.0.4)
-    sass (3.4.23)
+    sass (3.4.24)
     sawyer (0.8.1)
       addressable (>= 2.3.5, < 2.6)
       faraday (~> 0.8, < 1.0)
-    terminal-table (1.7.3)
+    terminal-table (1.8.0)
-      unicode-display_width (~> 1.1.1)
+      unicode-display_width (~> 1.1, >= 1.1.1)
     thread_safe (0.3.6)
     typhoeus (0.8.0)
       ethon (>= 0.8.0)
     tzinfo (1.2.3)
       thread_safe (~> 0.1)
-    unicode-display_width (1.1.3)
+    unicode-display_width (1.2.1)
     yell (2.0.7)
 
 PLATFORMS

_config.yml

@@ -25,7 +25,6 @@ excerpt_separator: <!--end_excerpt-->
 compress_html:
   clippings: all
   comments: all
-  endings: all
   blanklines: false
   profile: false
 

_sass/base/_common.scss

@@ -60,13 +60,7 @@ th {
   color: $linkHoverColor !important;
 }
 
-
 #content-container {
-  /* overrides overflow:visible, which overlays on top of floating elements, i.e. the toc on /docs/reference/commands/istioctl.html */
-  code[class*="language-"], pre[class*="language-"]{
-//    z-index: -1;
-  }
-
   div.toolbar {
     top: -2px;
   }

_sass/base/_markdown.scss

@@ -4,7 +4,6 @@
   // Text Blocks
   p {
     margin: 10px 0;
-    font-weight: 300;
     line-height: 1.5;
     @media (min-width: $tablet) {
       margin: 20px 0;
@@ -39,7 +38,6 @@
   ul {
     list-style: initial;
     font-size: $font-size--primary;
-    font-weight: 300;
     margin: 0 20px;
 
     @media (max-width: 768px) {

_sass/base/_override.scss

@@ -2,12 +2,10 @@
 // Override Bootstrap defaults
 body {
   color: $textColor;
-  font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif;
 }
 
 a {
   color: $mainBrandColor;
-  font-weight: 500;
 }
 
 a:hover,

_sass/base/_text.scss

@@ -1,3 +1,26 @@
+body {
+  font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif;
+  font-weight: normal;
+}
+
+p, ul, td, ol {
+  font-weight: normal;
+}
+
+a {
+  font-weight: 500;
+}
+
+p {
+  font-size: $font-size--xs;
+  line-height: 1rem;
+}
+
+p.lead {
+  font-size: $font-size--m;
+  font-weight: 500;
+}
+
 h1 {
   font-size: $font-size--xxl;
   color: $secondBrandColor;
@@ -6,7 +29,6 @@ h1 {
 
 h2 {
   font-size: $font-size--xl;
-  font-weight: 300;
   color: $black;
 }
 
@@ -19,12 +41,13 @@ h3 {
 
 h4 {
   font-size: $font-size--l;
+  font-weight: 500;
   margin: $spacing--m 0;
 }
 
 h5 {
   font-size: $font-size--s;
-  font-weight: 300;
+  font-weight: 500;
   color: $black;
 }
 
@@ -34,17 +57,7 @@ h6 {
   color: $black;
 }
 
-p {
+figcaption {
-  font-size: $font-size--xs;
-  font-weight: 300;
-  line-height: 1rem;
-}
-
-p.lead {
   font-size: $font-size--m;
-  font-weight: 400;
+  font-weight: 500;
-}
-
-td {
-  font-weight: 300;
 }

_sass/layouts/_landing.scss

@@ -100,7 +100,7 @@
     padding: 20px 20px 20px 20px;
 
     p {
-      font-weight: 300;
+      font-weight: normal;
       font-size: 100%;
     }
   }