Update README
Add instructions on features and developer instructions.
# Libnetwork plugin for Calico
This plugin for Docker networking ([libnetwork](https://github.com/docker/libnetwork)) is intended for use with [Project Calico](http://www.projectcalico.org).
-The plugin is integrated with the `calico/node` image which is created from the [calico-containers](https://github.com/projectcalico/calico-containers) repository.
+The plugin is integrated with the `calico/node` image which is created from the [calicoctl](https://github.com/projectcalico/calicoctl) repository, but it can also be run in it's own Docker container or as a standalone binary.
Guides on how to get started with the plugin and further documentation is available from http://docs.projectcalico.org
-The remaining information is for advanced users.
+## Supported options for confguration
-## How to Run It
+### Working with Networks
+* When creating a network, the `--subnet` option can be passed to `docker network create`. The subnet must match an existing Calico pool, and any containers created on that network will use an IP address from that Calico Pool.
+* Other than `--driver` and `--ipam-driver`, no other options are supported on the `docker network create` command.
+
+### Working with Containers
+When creating containers, use the `--net` option to connect them to a network previously created with `docker network create`
+
+* The `--ip` option can be passed to `docker run` to assign a specific IP to a container.
+* The `--mac` and `--link-local` options are currently unsupported.
+
+## Working with the code
+
+* Clone the repo (clone it into your GOPATH and make sure you use projectcalico in the path, not your fork name).
+* Create the vendor directory (`make vendor`). This uses `glide` in a docker container to create the vendor directory.
+* Build it in a container using `make dist/libnetwork-plugin`. The plugin binary will appear in the `dist` directory.
+* Running tests can be done in a container using `make test-containerized`. Note: This works on linux, but can require additional steps on Mac.
+* Submit PRs through GitHub. Before merging, you'll be asked to squash your commits together, so 1 PR = 1 commit.
+* Before submitting your PR, please make sure tests pass and run `make static-checks`. Both these will be done by the CI system too though.
+
+## How to Run It During Development
`make run-plugin`
Running the plugin in a container requires a few specific options
