Implemented middleware in a somewhat stateless fashion

README.md

@@ -6,29 +6,36 @@ A stock exchange simulator.  The scope of this project is not yet defined but it
 allow end user(s?) to exchange securities via the common exchange rules.
 
 
-## Installation
-Okay, this should be easy but it is hard... 
+## Getting Started
+
+### Development
+
+In development, you need nothing else than [clojure](https://clojure.org/)
+and [leiningen](https://leiningen.org/).  The easiest way to install clojure is
+to make sure you have java (8 and above) and install leiningen.
+
+### Production
+
+You will need plenty of things, the majority of them are yet to define.
+But, a good kafka deployment will be required.  Probably a database,
+hopefully datomic.
 
 
 ### Configuration
 All configuration are set in the `resources/config.edn` file.
-Configuration uses [aero](https://github.com/juxt/aero).
+Configuration uses [aero](https://github.com/juxt/aero).  The configuration
+file should be self documented.
 
 ### Technologies
 
 #### Server
-* clojure
-* kafka
+* [clojure](https://clojure.org/) for programming language
+* [kafka](http://kafka.apache.org/) for message broker/database
 
 #### In the browser
-* https://aftertheflood.com/projects/sparks/
-* http://metricsgraphicsjs.org/
-
-## Usage
-
-FIXME: explanation
-
-    $ java -jar book-0.1.0-standalone.jar [args]
+* [clojure script](https://clojurescript.org/) for programming language
+* [sparks](https://aftertheflood.com/projects/sparks/) for trivial charts
+* [metricsgraphicsjs](http://metricsgraphicsjs.org/) for complex charts