Our current devref gives a very light description of how to return API errors to callers. This patch improves it to describe all mechanisms currently supported by Cinder. Change-Id: Ie3c39e6ec042332c813ee7c851ba993a4a58c907