WIP

docs/tasks/index.md

@@ -0,0 +1,15 @@
+---
+title: Tasks 
+layout: docwithnav
+---
+
+This section contains pages that show how to do individual tasks. A task page
+shows how to do a single thing, typically given by a short sequence of steps.
+
+# Install a Broker
+
+How to add a broker to your catalog. This will make the services that broker
+available to users on your cluster. Adding it as a Cluster Service Broker
+(CSB) will make it available cluster-wide. Adding it as a Service Broker,
+also called a Namespaced Service Broker (NSB) will make it available
+only in a single namespace.

docs/tasks/install_broker.md

@@ -0,0 +1,6 @@
+---
+title: Install a Cluster Broker
+layout: docwithnav
+---
+
+You learn to foobar

docsite/_config.yml

@@ -50,15 +50,15 @@ plugins:
 # Tables of contents, stored in the _data folder, that control the sidebar nav
 # In order for a page to have a TOC, it's data file name must be included in this list.
 tocs:
-  - install
-  - devguide
-  - cli
-  - walkthrough
+  - catalog-restrictions
   - cli
   - concepts
-  - resources
+  - devguide
+  - install
+  - ladder
   - namespaced-broker-resources
-  - catalog-restrictions
+  - resources
   - service-plan-defaults
-  - ladder
+  - tasks
+  - walkthrough
   - docs-home # fallthrough, leave this last

docsite/_data/tasks.yml

@@ -1,5 +1,7 @@
 bigheader: "Tasks"
-abstract: "Step-by-step instructions for performing operations with Kubernetes."
-landing_page: /docs/tasks/index/
+abstract: "Instructions for performing various Service Catalog tasks."
+landing_page: /docs/tasks
 toc:
-- docs/docs/tasks/index.md
+- docs/tasks/index.md
+- title: Install a Broker
+  path: /docs/tasks/install_broker

docsite/_layouts/docsportal.html

@@ -14,10 +14,11 @@ <h5>{{ page.abstract }}</h5>
   <div id="vendorStrip" class="light-text">
     <ul>
       <li><a href="/docs/" {% if toc.bigheader == nil %}class="YAH"{% endif %}>HOME</a></li>
+      <li><a href="/docs/concepts" {% if toc.bigheader == "Concepts" %}class="YAH"{% endif %}>CONCEPTS</a></li>
+      <li><a href="/docs/tasks" {% if toc.bigheader == "Tasks" %}class="YAH"{% endif %}>TASKS</a></li>
       <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>
     </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

@@ -23,10 +23,11 @@ <h5>{{ toc.abstract }}</h5>
   <div id="vendorStrip" class="light-text">
     <ul>
       <li><a href="/docs/" {% if toc.bigheader == nil %}class="YAH"{% endif %}>HOME</a></li>
+      <li><a href="/docs/concepts" {% if toc.bigheader == "Concepts" %}class="YAH"{% endif %}>CONCEPTS</a></li>
+      <li><a href="/docs/tasks" {% if toc.bigheader == "Tasks" %}class="YAH"{% endif %}>TASKS</a></li>
       <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/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>
     </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">