Document the API versioning enhancements (which include :path versioning)

Fixes #63

Signed-off-by: Josep M. Blanquer <blanquer@rightscale.com>
Merge pull request #66 from rightscale/63-path_versioning_docs

Document the API versioning enhancements (including :path versioning)