Update and revamp documentation

new-manual.md

@@ -0,0 +1,118 @@
+Proposed outline of new documentation. Each heading is a page, with bullet
+points explaining content.
+
+Pages:
+
+<!-- MarkdownTOC -->
+
+* [Introduction](#introduction)
+* [Installation](#installation)
+* [Tutorial](#tutorial)
+    * [Getting Started](#getting-started)
+    * [Libraries](#libraries)
+    * [Directory Structure](#directory-structure)
+    * [Next Steps](#next-steps)
+* [Configuration and CLI](#configuration-and-cli)
+    * [build](#build)
+    * [update](#update)
+    * [visualize](#visualize)
+* [Inheritance and Merging](#inheritance-and-merging)
+* [Metadata](#metadata)
+* [Manifests](#manifests)
+* [Processors](#processors)
+    * [Kubernetes (:kube)](#kubernetes-kube)
+* [Advanced techniques](#advanced-techniques)
+    * [In-line Clojure](#in-line-clojure)
+    * [Rolling out changes](#rolling-out-changes)
+
+<!-- /MarkdownTOC -->
+
+# Introduction
+
+* Intro
+* Rationale
+
+# Installation
+
+* Comprehensive installation instructions
+
+# Tutorial
+
+## Getting Started
+
+* Installation
+* Intro to EDN
+* First run
+* 0 to first Kubernetes manifest generated
+
+## Libraries
+
+* Parent libraries
+* Deep merging overview and examples
+* Extracting out parent libraries
+* Intro to metadata
+
+## Directory Structure
+
+* Typical directory structure
+* Intro to inheritance
+
+## Next Steps
+
+* Links to remaining documentation
+
+# Configuration and CLI
+
+* Summary
+* Configuration
+
+## build
+
+* Examples
+
+## update
+
+* Examples
+
+## visualize
+
+* Examples
+
+# Inheritance and Merging
+
+* Tree project structure
+* Merging logic
+* Deep merge examples
+
+# Metadata
+
+* Metadata definition and use
+* Metadata in files
+
+# Manifests
+
+* Rationale
+* Examples
+
+# Processors
+
+* General information
+
+## Kubernetes (:kube)
+
+* Special metadata (tags)
+* Special vectors of maps
+* Environment handling
+
+# Advanced techniques
+
+## In-line Clojure
+
+* Intro to Clojure
+* Examples
+* Catalog of included libraries
+
+## Rolling out changes
+
+* Environment-specific override
+* Code conditional