Update README.md

Author: jeffmaki

README.md

@@ -1,11 +1,17 @@
-# Contents of This Repo
+# Dev Standards
 
-## Branch Strategy
+### Branch Strategy
 
 * **main**: day to day work goes here. 
 * **dev**: current code of the dev environment. No commits allowed directly; you'll need to open a PR from main. Committing/pushing here causes a deployment to the dev infrastructure. 
 
-## Frontend Tier
+### GH Actions
+
+See GitHub's actions tab in this repo for more deployment examples/steps. 
+
+# System Overview
+
+### Frontend Tier
 * ```frontend```: The Workspaces frontend (VueJS app).
   * Code here: https://github.com/TaskarCenterAtUW/workspaces-frontend.
   * Uses the other components within this repo, e.g. ```osm-rails```, ```osm-cgimap``` and ```tasking-manager``` as an API backend.
@@ -15,14 +21,16 @@
     * Workspaces version in the ```workspaces``` branch. Need to pull from public version periodically to keep up to date. 
     * Public version: tries to be a match to ```main``` of upstream. 
 
-## Backend Tier
+### Backend Tier
 * ```osm-web```: Reverse proxy that dispatches requests to osm-cgimap or osm-rails depending on performance requirements.   
   * ```osm-log-proxy```: sits in front of the below two services, logs requests for debugging purposes.
     * ```osm-rails```: “reference implementation” for OSM API for editing. Slow.
     * ```osm-cgimap```: Faster version of osm-rails. API format the same as osm-rails. Only some functions of osm-rails. 
 * ```tasking-manager```: Not currently using, but task manager for OSM. 
-  
-# To build images
+
+# Getting Started
+
+### To build images
 
 ```git clone --recursive https://github.com/TaskarCenterAtUW/workspaces-stack.git```
 
@@ -32,17 +40,14 @@
 
 Replace XXX.env with the environment definition file of the environment for which you want to build an image. This can be overridden when running (see below). 
 
-# To update docker daemon to run with latest images
+### To update docker daemon to run with latest images
 
 ```docker-compose -f docker-compose.deploy.yml --env-file XXX.env up -d -pull always --force-recreate --remove-orphans```
 
 Replace XXX.env with the environment definition file of the environment for which you are deploying.
 
-# Other Files
+### Other Files
 
 * ```example.env```: template of the .env file required by the Docker compose YAML files
 * ```tdei_uw.env```: .env for deployment at UW's TDEI center. Only UW should use this, new users should adapt example.env to suit their needs. LTG: remove this file from this repo. 
 
-# GH Actions
-
-See GitHub's actions tab in this repo for more deployment examples/steps.