Adding project documentation and roadmap planning

1 files changed, 49 insertions, 3 deletions

diff --git a/README b/README
index 71e5eed..03c661f 100644
--- a/README
+++ b/README
@@ -1,4 +1,50 @@
-webgit
-======
+       .'.'
+      .'-'.
+  .  (  o O)
+   \_ `  _,   _
+-.___'.) ( ,-'
+     '-.O.'-..-..       octopus git web frontend
+ ./\/\/ | \_.-._
+        ;
+     ._/
+
+
+A git web frontend that wants to hug your code.
+
+
+Configuration
+-------------
+
+octopus is easy to configure and run, even on systems that don't give
+you priviledged system access.  The main server binary is configured
+primarily with a few environment variables, and an app config.
+
++ OCTOPUS_CONFIG should contain the path of the main configuration
+
++ OCTOPUS_SSL_KEY can optionally be set to the path of a certificate key
+
++ OCTOPUS_SSL_CERT can optionally be set to the path of a certificate
+
+
+The main configuration file is written in yaml, and outlines things
+like the application domain, repo paths, and added modules.  Because
+octopus is vory modular, you can only depend on certain features.
+
+
+---
+app_path: git.octopus.example
+port: 8080
+handle_ssl: false
+cache_path: /var/cache/octopus
+repo_path: /var/lib/octopus/repos
+repo_discovery: false  # Disables automatic config loading from repo_path
+                       # and instead let's you set a static set of repos
+                       # in the section below
+repos:
+  - octopus:
+      description: "🐙 It's a water animal"
+      category: "/"
+  - libkookie:
+      description: "My personal nix expressions"
+      category: "/nix"
 
-The friendly and simple git web interface.
\ No newline at end of file