Some additional cleanup for WIP installation docs.

Signed-off-by: Josh Berkus <josh@agliodbs.com>

Author: jberkus

content/en/docs/Getting started/configuration.md

@@ -32,23 +32,26 @@ You must set up an "Oauth Application" that Elekto can use.  In GitHub, this is
 
 The Oauth App must have the following settings:
 
-*
+* Application Name: whatever you've named your Elekto instance
+* Homepage URL: the url of your Elekto instance
+* Authorization Callback URL: https://your.elekto.domain/oauth/github/callback  (note that this can be changed in ENV)
 
-Having configured this, you can populate GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET in Elekto's runtime environment.
+Once you create the Oauth App, GitHub will create a ClientID for it, which you populate in GITHUB_CLIENT_ID in ENV.  You then create a new Oauth secret under the app and copy the value for that, and that gets populated in GITHUB_CLIENT_SECRET.
 
 #### GitHub Repository Webhook
 
 In order to receive changes from the repo, you need to add a webhook that pushes changes whenever you merge.  Webhooks are under "settings" for the individual repository (which also means you must be a repo onwer).  
 
 The Webhook should have the following settings:
 
-* Push webhook
-* JSON data format
-* Use TLS
-* 
+* Payload URL: https://your.election.domain/v1/webhooks/meta/sync
+* Content Type: application/json
 * Shared Secret set to the same as META_SECRET
+* Enable SSL Verification
+* Just The Push Event
+* Check "Active" to turn it on
 
-This last "secret" is an arbitrary string that authenticates the push to the Elekto server.  It can be any string, such as one created by a password generator or a passphrase you like.  This string then gets set in META_SECRET. 
+This "secret" is an arbitrary string that authenticates the push to the Elekto server.  It can be any string, such as one created by a password generator or a passphrase you like.  This string then gets set in META_SECRET. 
 
 ## The Environment File
 
@@ -167,7 +170,7 @@ Example: `https://github.com/kalkayan/k8s.elections.meta.git`
 
 **ELECTION_DIR**
 
-*Required* Directory, relative to the Git repository root, containing the set of election subdirectories.  Can be an arbitrarily deep path.  Do not use a leading or trailing `/`.
+*Required* Directory, relative to the Git repository root, containing the set of election subdirectories. Must be a parent directory. Can be an arbitrarily deep path.  Do not use a leading or trailing `/`.
 
 Example: `elections`, `gov/steering/elections`
 

content/en/docs/Getting started/devinstall.md

@@ -0,0 +1,95 @@
+---
+title: "Development Installation"
+linkTitle: "Development Installation"
+weight: 1
+description: >
+  Create a dev install on your laptop
+---
+
+This guide will help you create a development installation of Elekto on your laptop, for hacking and testing purposes.
+
+## Create a development environment
+
+The application is written in `python` using `flask` and `sqlalchemy`. This repository ships a `requirements.txt` and  a `environment.yml` for conda users.
+
+```bash
+# Installation with pip 
+pip install -r requirements.txt
+
+# Installation with Conda
+conda env create -f environment.yml && conda activate elekto
+```
+
+## Setup env variables
+
+The repository has a `.env.example` file which can be used as a template for `.env` file, update the environment file after copying from `.env.example`.
+
+```bash
+# create a new .env file from .env.example
+cp .env.example .env
+```
+
+Set the basic information about the application in the upper section
+```bash
+APP_NAME=k8s.elections     # set the name of the application
+APP_ENV=development        # development | production   
+APP_KEY=                   # random secret key (!! important !!)
+APP_DEBUG=True             # True | False (production)
+APP_URL=http://localhost   # Url where the application is hosted
+APP_PORT=5000              # Default Running port for development 
+APP_HOST=localhost         # Default Host for developmemt 
+```
+
+Update the database credentials, 
+```bash
+DB_CONNECTION=mysql        # Mysql is only supported 
+DB_HOST=localhost
+DB_PORT=3306
+DB_DATABASE=name          
+DB_USERNAME=user
+DB_PASSWORD=password
+```
+
+Update the meta repository info
+```bash
+META_REPO=https://github.com/elekto-io/elekto.meta.test.git
+META_DEPLOYMENT=local
+META_PATH=meta
+META_BRANCH=main
+META_SECRET=db5a951969c379e75d0bf15ad6ff8b4a36fbeb02  # same as webhook of the same meta repository
+```
+
+Update the Oauth info, create an github oauth app if already not created.
+```bash
+GITHUB_REDIRECT=/oauth/github/callback
+GITHUB_CLIENT_ID=d79f002c1d2e3cf20521
+GITHUB_CLIENT_SECRET=2f64fff6612c46f87314ad5bb81d05c8fd29c561
+```
+
+#### Migrate and Sync DB with Meta
+
+The `console` script in the repository is used to perform all the table creations and syncing of the meta. 
+
+```bash
+# to migrate the database from command line 
+python console --migrate 
+```
+
+To sync the database with the meta files 
+
+```bash
+# to the sync the database with the meta
+python console --sync
+```
+
+#### Run the application Server locally 
+
+The flask server will start on `5000` by default but can be changed using `--port` option.
+
+```bash
+# to run the server on default configs
+python console --run
+
+# to change host and port
+python console --port 8080 --host 0.0.0.0 --run
+```

content/en/docs/Getting started/kubernetes.md

@@ -0,0 +1,11 @@
+---
+title: "Kubernetes Installation"
+linkTitle: "Kubernetes Installation"
+weight: 2
+description: >
+  Installing Elekto on Kubernetes
+---
+
+This guide walks you through installing Elekto on a Kubernetes cluster.
+
+TBD.