Add documentation comments for client
Add documentation comments for client

- the client will hold all the documentation for the internal
  configuration structures.
- make sure the http.CLient times out

joeshaw/shuttle,jwilder/shuttle,litl/shuttle