API documentation for Hierarchical Multitenancy

Changes regarding the functionality of Hierarchical Multi Tenancy

- API Creation to inherited roles for projects
- Changes in the Keystone API considering nested projects.

Depends On: blueprint hierarchical-multitenancy

Change-Id: Ieecb24c07e5e9d5e7215398244057a6d87501cfc