updates README

Author: githubsands

README.md

@@ -2,9 +2,9 @@
 
 # High level
 
-Builds a live orderbook from http snapshots from N configurable exchanges and updates it through
-websocket depth updates. After a update the best ten asks and bids aswell as well as the spread 
-are provided through a grpc server endpoint
+Builds a live orderbook from http snapshots from N configurable exchanges and then updates the orderbook 
+through soft real time websocket depth updates. After a update the best ten asks and bids aswell as well 
+as the spread are provided through a grpc server endpoint
 
 # Lower level
 
@@ -13,13 +13,27 @@ pinned threads.
 
 Orderbook is ran with multiplie threads. One for writing to the book the others for reading it.
 
+## Orderbook structure
+
+// todo -- update my reasoning here ... on why i didn't just use a simple red black tree
+
+# Configuration
+
+Exchange boots through a config by running `./orderbook-quoter-server --config=$(CONFIG_LOCATION)`. The 
+amount of exchanges in the exchange array must be equal to the orderbook's `exchange_count`. Every
+`depth` field must be equal in the exchanges and orderbook's depth field should cover the entire 
+expected trading range for the lifetime of this service. 
+
+The larger expected volatility the higher the orderbook's depth needs to be.
+
 # Configuration
 
 Exchange boots through a config by running `./orderbook-quoter-server --config=$(CONFIG_LOCATION)`. The 
 amount of exchanges in the exchange array must be equal to the orderbook's `exchange_count`. Every
 `depth` field must be equal in the exchanges and orderbook's depth field should cover the entire 
-expected trading range for the lifetime of this service. The larger expected volatility the higher the orderbook's
-depth needs to be.
+expected trading range for the lifetime of this service. 
+
+The larger expected volatility the higher the orderbook's depth needs to be.
 
 ```       
 exchanges:
@@ -85,9 +99,9 @@ Wrapper around exchange stream to handle websocket sinks and other functionality
 
 ### DepthDriver
 
-Provides a controlling interface to all exchange streams. 
+Provides a controlling interface to all exchange streams that push depths.
 
-Future work: 
+#### Future work: 
 
 (1) Needs to handle orderbook reset and orderbook snapshot
 retriggering with correct sequencing (https://github.com/binance/binance-spot-api-docs/blob/master/web-socket-streams.md#how-to-manage-a-local-order-book-correctly)
@@ -104,7 +118,7 @@ Has 2 states:
 
 (2) Updating the the orderbook with ws depths and then reading the orderbook for best deals
 
-Future work: 
+#### Future work: 
 
 (1) A state when the orderbook is needs rebuilding if a ExchangeStream websocket connection fails. 
 
@@ -122,24 +136,27 @@ Future work:
 
 #### 1. Depth Generator
 
-Generates depths in many different sequences.
+Generates depths in many different sequences: upward, downward through
+hacking a brownian motion stochastic process.
 
-Future Work:
+##### Future Work:
 
 Oscillating Depths rather then just upward and downward trends
 
 #### 2. Exchange Stubs
 
-Provides both HTTP and websocket endpoints for depths. Leverages depth generator.
+Provides both HTTP and websocket endpoints for depths. Leverages depth generator
+as a dependency.
 
 #### 3. Exchange Server
 
-Dockerized exchange stub for full integration testing.
+Dockerized exchange stub for full integration testing. Leverages exchange stub as a
+dependency.
 
 ### Quote GRPC Server
 
 Takes the spread and provides the best ten deals and asks to a grpc client
 
-Future work:
+#### Future work:
 
 TBD