Merge pull request #284 from jrperritt/remove-BuildQuery
update functions to use BuildQueryString instead of BuildQuery
diff --git a/README.md b/README.md
index 14ce7c1..9f7552b 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
-# gophercloud: the OpenStack SDK for Go
+# Gophercloud: the OpenStack SDK for Go
[](https://travis-ci.org/rackspace/gophercloud)
-gophercloud is a flexible SDK that allows you to consume and work with OpenStack
+Gophercloud is a flexible SDK that allows you to consume and work with OpenStack
clouds in a simple and idiomatic way using golang. Many services are supported,
including Compute, Block Storage, Object Storage, Networking, and Identity.
Each service API is backed with getting started guides, code samples, reference
@@ -9,7 +9,7 @@
## Useful links
-* [gophercloud homepage](http://gophercloud.io)
+* [Gophercloud homepage](http://gophercloud.io)
* [Reference documentation](http://godoc.org/github.com/rackspace/gophercloud)
* [Getting started guides](http://gophercloud.io/docs)
* [Effective Go](https://golang.org/doc/effective_go.html)
@@ -17,21 +17,28 @@
## How to install
Before installing, you need to ensure that your [GOPATH environment variable](https://golang.org/doc/code.html#GOPATH)
-is pointing to an appropriate directory where you want to install gophercloud:
+is pointing to an appropriate directory where you want to install Gophercloud:
```bash
mkdir $HOME/go
export GOPATH=$HOME/go
```
-Once this is set up, you can install the gophercloud package like so:
+To protect yourself against changes in your dependencies, we highly recommend choosing a
+[dependency management solution](https://code.google.com/p/go-wiki/wiki/PackageManagementTools) for
+your projects, such as [godep](https://github.com/tools/godep). Once this is set up, you can install
+Gophercloud as a dependency like so:
```bash
go get github.com/rackspace/gophercloud
+
+# Edit your code to import relevant packages from "github.com/rackspace/gophercloud"
+
+godep save ./...
```
-This will install all the source files you need into a `pkg` directory, which is
-referenceable from your own source files.
+This will install all the source files you need into a `Godeps/_workspace` directory, which is
+referenceable from your own source files when you use the `godep go` command.
## Getting started
@@ -60,9 +67,9 @@
### Authentication
Once you have access to your credentials, you can begin plugging them into
-gophercloud. The next step is authentication, and this is handled by a base
+Gophercloud. The next step is authentication, and this is handled by a base
"Provider" struct. To get one, you can either pass in your credentials
-explicitly, or tell gophercloud to use environment variables:
+explicitly, or tell Gophercloud to use environment variables:
```go
import (