Updates Block Storage v1 and v2 APIs with generalized info

- Adds info from dev ref to the API Reference page

Change-Id: I51ac1ea90473db47171fc6d59ce6bbc57ca79ef3
Merge "Updates Block Storage v1 and v2 APIs with generalized info"