diff --git a/.gitignore b/.gitignore
index 1a7501b4..ddf8c78a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,11 +9,13 @@ bin
 /docker-compose.yml
 changes.txt
 
-# Ignore built site
+# Ignore site documents / when switching branches
 docs/_site/
 docs/.jekyll-cache/
 docs/.git/
 docs/.gitignore
+_site/
+.jekyll-cache/
 
 #
 # GO SPECIFIC
diff --git a/docs/README.md b/docs/README.md
index d6aec433..81fae2ff 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,5 +5,3 @@ bundle exec jekyll serve .
 ```
 
 And visiting `localhost:4000` on your browser.
-
-This website is synced to the `gh-pages` branch.
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
index 40e0609e..92e3748f 100644
--- a/docs/_layouts/default.html
+++ b/docs/_layouts/default.html
@@ -6,6 +6,7 @@
     <meta charset="utf-8">
     <title>{{ site.title }} - {{ page.title }}</title>
     <meta name="title" content="{{ site.title }} - {{ page.title }}">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
 
     {% include meta.html %}
 
@@ -19,13 +20,9 @@
         <div class="first"><!-- Hero Section-->
           <div class="container">
             <div class="row">
-              <div class="hero-content wow fadeIn">
-                <div class="hero-content-inner">
-                  <div class="style markdown-body">
+                  <div class="markdown-body">
                     {{ content }}
                   </div>
-                </div>
-              </div>
             </div>
 
             <div class="questions flex-out align-center wow fadeIn">
diff --git a/docs/assets/css/style.css b/docs/assets/css/style.css
index 512ef7bf..1a76c3f7 100644
--- a/docs/assets/css/style.css
+++ b/docs/assets/css/style.css
@@ -421,7 +421,7 @@ body {
 }
 
 .first {
-  padding: 110px 10px 75px 0 !important;
+  padding: 110px 0 75px 0 !important;
 	background: #F7F7F8;
 }
 
@@ -3679,19 +3679,19 @@ font-family: "Open Sans";
   background: #F7F7F8;
 }
 
-	.markdown-body {
-		box-sizing: border-box;
-		min-width: 200px;
-		max-width: 980px;
-		margin: 0 auto;
-		padding: 45px;
-	}
+.markdown-body {
+  box-sizing: border-box;
+  min-width: 200px;
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 45px;
+}
 
-	@media (max-width: 767px) {
-		.markdown-body {
-			padding: 15px;
-		}
-	}
+@media (max-width: 767px) {
+  .markdown-body {
+    padding: 15px;
+  }
+}
 
 .code-example {
   margin: 0;
@@ -3704,3 +3704,7 @@ font-family: "Open Sans";
   color: #fff !important;
   font-size:13px;
 }
+
+.highlight {
+  background: #fff !important;
+}
diff --git a/docs/docs/images/design_diagram.png b/docs/docs/images/design_diagram.png
new file mode 100644
index 00000000..460d4abd
Binary files /dev/null and b/docs/docs/images/design_diagram.png differ
diff --git a/docs/docs/images/kompose-maven-output-diagram.png b/docs/docs/images/kompose-maven-output-diagram.png
new file mode 100644
index 00000000..307a4e90
Binary files /dev/null and b/docs/docs/images/kompose-maven-output-diagram.png differ