Merge pull request #42 from RachelTucker/GOSDK-2

GOSDK-2: Updating documentation for release

Author: rpmoore

README.md

@@ -3,8 +3,19 @@ Spectra S3 Go SDK
 
 [![Apache V2 License](http://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/SpectraLogic/ds3_go_sdk/blob/master/LICENSE.md)
 
-This is not an officially supported SDK.  This was created as an experiment for a much earlier version of the
-Spectra S3 API.  It is not compatible with the most recent version of Spectra S3.
+An SDK conforming to Spectra S3 for Golang 1.8
+
+Contact Us
+----------
+
+Join us at our [Google Groups](https://groups.google.com/d/forum/spectralogicds3-sdks) forum to ask questions, or see frequently asked questions.
+
+
+Contributing
+------------
+If you would like to contribute to the source code, sign the 
+[Contributors Agreement](https://developer.spectralogic.com/contributors-agreement/).  For an overview of how we use 
+Github, please review our [Github Workflow](https://github.com/SpectraLogic/spectralogic.github.com/wiki/Github-Workflow).
 
 Installing with GB
 ------------------
@@ -22,6 +33,25 @@ cd ds3_go_sdk
 gb build all
 ```
 
+Client
+---------
+In the ds3_go_sdk you create a `Client` instance through the setting of the following environment variables and using `buildclient.FromEnv()`.
+
+* `DS3_ENDPOINT` - The URL to the DS3 Endpoint
+* `DS3_ACCESS_KEY` - The DS3 access key
+* `DS3_SECRET_KEY` - The DS3 secret key
+* `http_proxy` - If set, the `Client` instance will proxy through this URL
+
+Examples
+--------
+All examples are listed in the [samples](src/samples/) module.
+
+* [How to use get service to list buckets](src/samples/getServiceSample.go)
+* [How to create a bucket](src/samples/getBucketSample.go)
+* [How to get a single object using a naked S3 get](src/samples/getObjectSample.go)
+* [How to use bulk put to send multiple files to the BP efficiently](src/samples/putBulkSample.go)
+* [How to use bulk get to retrieve multiple files from the BP efficiently](src/samples/getBulkSample.go)
+
 Running Tests with GB
 ---------------------