Merge pull request #77 from deis/docs-readme

doc(readme): updates to reflect changes in beta3 iteration

Author: jackfrancis

README.md

@@ -3,7 +3,7 @@
 The Workflow Manager Service API is responsible for interfacing with Deis Workflow data. It is a golang https implementation that speaks JSON. The API is the source of authority for the following:
 
 * metadata about unique Deis clusters that have checked in: which components are installed at the time of check-in, and which versions
-* current stable version for each Deis cluster component
+* released version history for each Deis cluster component
 
 Additionally, the API is the official interface for accepting Workflow Manager data, e.g.:
 

data/README.md

@@ -23,11 +23,14 @@ Data is organized into three tables, with fields outlined below:
   * `cluster_id uuid`
   * `created_at timestamp`
   * `data json`
-  * with a uniqueness constraint `unique (cluster_id, created_at)`
 * `versions`, a table that stores authoritative deis component version information
-  * `component_name varchar(64) PRIMARY KEY`
-  * `last_updated timestamp`
+  * `version_id bigserial PRIMARY KEY`
+  * `component_name varchar(32)`
+  * `train varchar(24)`
+  * `version varchar(32)`
+  * `release_timestamp timestamp`
   * `data json`
+  * with a uniqueness constraint `unique (component_name, train, version)`
 
 ## License