docs(README.md): add shellcheck link and usage example

Author: mboersma

README.md

@@ -7,23 +7,46 @@ The go-dev docker container provides a lightweight Go development environment fo
 
 ## Image Contents
 
-* based on the [official go Docker image](https://hub.docker.com/_/golang/)
-* [glide](https://github.com/Masterminds/glide): go dependency management
-* [golint](https://github.com/golang/lint): go source code linter
-* [ginkgo](https://github.com/onsi/ginkgo): BDD testing framework for go
-* [upx](http://upx.sourceforge.net/): executable packer
-* [gox](https://github.com/mitchellh/gox): simple go cross-compiling tool
+* based on the [official go Docker image][]
+* [ginkgo][]: BDD testing framework for go
+* [glide][]: go dependency management
+* [golint][]: go source code linter
+* [gox][]: simple go cross-compiling tool
+* [shellcheck][]: static analysis for shell scripts
+* [upx][]: executable packer
 
 ## Usage
 
-The latest Docker image is available via:
+Mount your local go code into a container's `$GOPATH` to run any `go` command or one of the
+included tools or scripts. Here's an example of running `glide up` for deis/builder:
 
-* [Quay.io](https://quay.io)
+```console
+$ docker run --rm \
+  --env GO15VENDOREXPERIMENT=1 \
+  --volume $GOPATH/src/github.com/deis/builder:/go/src/github.com/deis/builder \
+  --workdir /go/src/github.com/deis/builder \
+  quay.io/deis/go-dev:latest \
+  glide up
+```
+
+The latest deis/go-dev Docker image is available at:
+
+* [Quay.io][]
   ```
   docker pull quay.io/deis/go-dev
   ```
 
-* [Docker Hub](https://hub.docker.com)
+* [Docker Hub][]
   ```
   docker pull deis/go-dev
   ```
+
+[Docker Hub]: https://hub.docker.com
+[ginkgo]: https://github.com/onsi/ginkgo
+[glide]: https://github.com/Masterminds/glide
+[golint]: https://github.com/golang/lint
+[gox]: https://github.com/mitchellh/gox
+[official go Docker image]: https://hub.docker.com/_/golang/
+[Quay.io]: https://quay.io
+[shellcheck]: https://github.com/koalaman/shellcheck
+[upx]: http://upx.sourceforge.net/