Document references.

This adds documentation for references, e.g. an EC2 instance has a `vpc`
and a `subnet` reference. This also documents reverse references discovered
through the `subResources` association, such as an S3 object having a `bucket`
reference. Previously these were not documented.
Merge pull request #18 from boto/docs-refs

Document references.