Update README

Signed-off-by: Tibor Vass <tibor@docker.com>

README.md

@@ -1,2 +1,41 @@
-# go-docker
+# docker.io/go-docker
 Official Go SDK for Docker
+
+# Dependency management tool is required
+
+This repository describes its dependencies in a `Gopkg.toml` file as created by the [`dep`](https://github.com/golang/dep#setup) tool.
+
+It also uses semantic versioning, and requires its users to use `dep`-compatible dependency management tools to ensure stability and avoid breaking changes.
+
+The canonical import path is `docker.io/go-docker`.
+
+Note: you may download it with `go get -d docker.io/go-docker`, but if you omit `-d`, you may have compile errors. Hence the `dep` approach is preferred.
+
+## How to use `dep` in your project
+
+You can use any tool that is compatible, but in the examples below we are using `dep`.
+
+### Adding dependency to `vendor/`
+
+```bash
+$ cd $GOPATH/src/myproject
+$ dep init 					# only if first time use
+$ dep ensure -add docker.io/go-docker@v1    	# to use the latest version of v1.x.y
+```
+
+### Updating dependency
+
+```bash
+$ cd $GOPATH/src/myproject
+$ edit Gopkg.toml
+$ dep ensure
+```
+
+# Reference Documentation
+
+[godoc.org/docker.io/go-docker](https://godoc.org/docker.io/go-docker)
+
+# Issues
+
+Feel free to open issues on the Github issue tracker.
+