WIP

docs/README.md

@@ -8,7 +8,7 @@ permalink: /docs/
 # Service Catalog Documentation
 
 This page is an index for the articles in here. We recommend you start by reading the 
-[introduction](./concepts/index.md#introduction), and then move on to the 
+[introduction](introduction.md), and then move on to the 
 [installation instructions](./install.md). After you install, see our
 [walkthrough](./walkthrough.md) document to get started using Service Catalog.
 

docs/concepts/index.md → docs/introduction.md

@@ -1,9 +1,9 @@
 ---
-title: Concepts
+title: Introduction
 layout: docwithnav
 ---
 
-## Introduction
+## Foobar
 
 The service-catalog project is in incubation to bring integration with service
 brokers to the Kubernetes ecosystem via the [Open Service Broker API](https://github.com/openservicebrokerapi/servicebroker).
@@ -77,4 +77,4 @@ These concepts and resources are the building blocks of the service catalog.
 
 ## Service Resources
 
-See [Resources](../resources.md) for details on each Service Catalog resource (or type).
+See [Resources](./resources.md) for details on each Service Catalog resource (or type).

docsite/_data/globals.yml

@@ -2,5 +2,5 @@ tocs:
   - install
   - walkthrough
   - cli
-  - concepts
+  - introduction
   - docs-home # fallthrough, leave this last

docsite/_data/introduction.yml

@@ -0,0 +1,12 @@
+bigheader: "Introduction"
+abstract: "Detailed explanations of Service Catalog system concepts and abstractions."
+landing_page: /docs/introduction/
+toc:
+- docs/introduction.md
+- title: Foobar
+  path: /docs/introduction/#foobar
+- title: Overview
+  path: /docs/introduction/#overview
+- title: Service Resources
+  path: /docs/introduction/#service-resources
+

docsite/_layouts/docsportal.html

@@ -17,7 +17,7 @@ <h5>{{ page.abstract }}</h5>
       <li><a href="/docs/install" {% if toc.bigheader == "Install" %}class="YAH"{% endif %}>INSTALL</a></li>
       <li><a href="/docs/walkthrough" {% if toc.bigheader == "Walkthrough" %}class="YAH"{% endif %}>WALKTHROUGH</a></li>
       <li><a href="/docs/cli" {% if toc.bigheader == "CLI" %}class="YAH"{% endif %}>CLI</a></li>
-      <li><a href="/docs/concepts" {% if toc.bigheader == "Concepts" %}class="YAH"{% endif %}>CONCEPTS</a></li>
+      <li><a href="/docs/introduction" {% if toc.bigheader == "Introduction" %}class="YAH"{% endif %}>INTRODUCTION</a></li>
     </ul>
     <div id="searchBox">
       <input type="text" id="search" placeholder="Search" onkeydown="if (event.keyCode==13) window.location.replace('/docs/search/?q=' + this.value)" autofocus="autofocus">

docsite/_layouts/docwithnav.html

@@ -26,7 +26,7 @@ <h5>{{ toc.abstract }}</h5>
       <li><a href="/docs/install" {% if toc.bigheader == "Install" %}class="YAH"{% endif %}>INSTALL</a></li>
         <li><a href="/docs/walkthrough" {% if toc.bigheader == "Walkthrough" %}class="YAH"{% endif %}>WALKTHROUGH</a></li>
         <li><a href="/docs/cli" {% if toc.bigheader == "CLI" %}class="YAH"{% endif %}>CLI</a></li>
-        <li><a href="/docs/concepts" {% if toc.bigheader == "Concepts" %}class="YAH"{% endif %}>CONCEPTS</a></li>
+        <li><a href="/docs/introduction" {% if toc.bigheader == "Introduction" %}class="YAH"{% endif %}>INTRODUCTION</a></li>
     </ul>
     <div id="searchBox">
       <input type="text" id="search" placeholder="Search" onkeydown="if (event.keyCode==13) window.location.replace('/docs/search/?q=' + this.value)" autofocus="autofocus">

docsite/index.html

@@ -28,7 +28,7 @@ <h5>Bringing the Cloud Back Into Your Cluster</h5>
     <main>
         <div class="image-wrapper"><img src="images/flower.png"></div>
         <div class="content">
-            <h3><a href="/docs/concepts/#introduction">Service Catalog</a> lets you
+            <h3><a href="/docs/introduction/#introduction">Service Catalog</a> lets you
                 provision cloud services directly from the comfort of native Kubernetes tooling.
             </h3>
             <p>