Documentation update for REST API

Partially implements blueprint docs-for-v02

Change-Id: Iea718fe8371b758e78c04e7c99cc6669105fde46
Merge "Documentation update for REST API"