docs(scheduler): add and update README.md files

Fixes #705.

Author: mboersma

README.md

@@ -1,23 +1,48 @@
-# Deis Server
+# Deis Controller
 
-A Docker image containing a REST API and web server, for use in the [Deis](http://deis.io) open source PaaS.
+A RESTful API server for use in the [Deis](http://deis.io) open
+source PaaS.
 
 [![image](https://d207aa93qlcgug.cloudfront.net/img/icons/framed-icon-checked-repository.svg)](https://index.docker.io/u/deis/controller/)
 
 [**Trusted Build**](https://index.docker.io/u/deis/controller/)
 
-This Docker image is based on the trusted build [deis/base](https://index.docker.io/u/deis/base/), which itself is based on the official [ubuntu:12.04](https://index.docker.io/_/ubuntu/) base image.
+This Docker image is based on the trusted build
+[deis/base](https://index.docker.io/u/deis/base/), which itself is based
+on the official [ubuntu:12.04](https://index.docker.io/_/ubuntu/) image.
 
-Please add any issues you find with this software to the parent [Deis project](https://github.com/opdemand/deis/issues).
+Please add any issues you find with this software to the
+[Deis project](https://github.com/opdemand/deis/issues).
 
 ## Usage
 
-Coming Soon!
+* `make build` builds the *deis/controller* image inside a vagrant VM
+* `make run` installs and starts *deis/controller*, then displays log
+  output from the container
+* `make test` runs unit tests for the controller and reports results
+
+## Environment Variables
+
+* **DEBUG** enables verbose output if set
+* **ETCD_PORT** sets the TCP port on which to connect to the local etcd
+  daemon (default: *4001*)
+* **ETCD_PATH** sets the etcd directory where the controller announces
+  its configuration (default: */deis/controller*)
+* **ETCD_TTL** sets the time-to-live before etcd purges a configuration
+  value, in seconds (default: *10*)
+* **PORT** sets the TCP port on which the controller listens for API
+  requests (default: *8000*)
 
 ## License
 
-Copyright 2014 OpDemand LLC
+© 2014 OpDemand LLC
 
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <http://www.apache.org/licenses/LICENSE-2.0>
+Licensed under the Apache License, Version 2.0 (the "License"); you may
+not use this file except in compliance with the License. You may obtain
+a copy of the License at <http://www.apache.org/licenses/LICENSE-2.0>
 
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.