Added documentation for the quota definition

Signed-off-by: Tim Labeeuw <tlabeeuw@pivotallabs.com>
Made the inline-relations-depth paramenter deprecated for all docs

Signed-off-by: Tim Labeeuw <tlabeeuw@pivotallabs.com>
Reformat and added description to cloud_controller/runner

Signed-off-by: Tim Labeeuw <tlabeeuw@pivotallabs.com>
Ensure all required attributes are provided example_values and/or
valid_values in API tests.

Using the example and valid values in all tests when doing PUT/POST endpoints.

Signed-off-by: Tim Labeeuw <tlabeeuw@pivotallabs.com>