Fix v3-docs not including "warning" field for Jobs

* Looks like this was added way back in 903275d

[#172704712]

Authored-by: Aakash Shah <ashah@pivotal.io>

Author: Aakash Shah

docs/v3/source/includes/api_resources/_jobs.erb

@@ -10,7 +10,8 @@
       "href": "https://api.example.org/v3/jobs/b19ae525-cbd3-4155-b156-dc0c2a431b4c"
     }
   },
-  "errors": []
+  "errors": [],
+  "warnings": []
 }
 <% end %>
 
@@ -35,6 +36,11 @@
       "title": "CF-UnprocessableEntity",
       "detail": "something went wrong"
     }
+  ],
+  "warnings": [
+    {
+      "detail": "warning! warning!"
+    }
   ]
 }
 <% end %>

docs/v3/source/includes/concepts/_warnings.md.erb

@@ -0,0 +1,21 @@
+## Warnings
+
+```
+Example Warnings
+```
+```json
+{
+  "warnings": [
+    {
+      "detail": "something went wrong"
+    }
+  ]
+}
+```
+
+#### The warning object
+
+Name | Type | Description
+---- | ---- | -----------
+**detail** | _string_ | Description of the warning.
+

docs/v3/source/includes/resources/jobs/_object.md.erb

@@ -16,5 +16,6 @@ Name           | Type | Description
 **state**      | _string_ | State of the job. Valid values are `PROCESSING`, `POLLING`, `COMPLETE`, or` FAILED`.
 **links**      | [_links object_](#links) | Links to related resources.
 **errors**     | [_errors list_](#errors) | Array of errors that occurred while processing the job.
+**warnings**     | [_warnings list_](#warnings) | Array of warnings that occurred while processing the job.
 
 Note: `POLLING` happens during asynchronous services operations that require polling the last operation from the service broker.

docs/v3/source/index.md

@@ -53,6 +53,7 @@ includes:
   - concepts/procfiles
   - concepts/relationships
   - concepts/status_codes
+  - concepts/warnings
   - resources/header
   - resources/apps/header
   - resources/apps/object