Merge branch 'sarnold-alert-management-ingestion-documentation' into 'master'

Add populating section to alert management docs, and mention severity

See merge request gitlab-org/gitlab!31567

doc/user/project/integrations/generic_alerts.md

@@ -32,12 +32,13 @@ You can customize the payload by sending the following parameters. All fields ar
 
 | Property | Type | Description |
 | -------- | ---- | ----------- |
-| `title` | String | The title of the incident. If none is provided, then `New: Incident #N` will be used, where `#N` is the number of incident |
+| `title` | String | The title of the incident. Required. |
 | `description` | String | A high-level summary of the problem. |
 | `start_time` | DateTime | The time of the incident. If none is provided, a timestamp of the issue will be used. |
 | `service` | String | The affected service. |
 | `monitoring_tool` | String |  The name of the associated monitoring tool. |
 | `hosts` | String or Array | One or more hosts, as to where this incident occurred. |
+| `severity` | String | The severity of the alert. Must be one of `critical`, `high`, `medium`, `low`, `info`, `unknown`. Default is `critical`. |
 
 Example request:
 

doc/user/project/operations/alert_management.md

@@ -12,10 +12,16 @@ NOTE: **Note:**
 You will need at least Maintainer [permissions](../../permissions.md) to enable the Alert Management feature.
 
 1. Follow the [instructions for toggling generic alerts](../integrations/generic_alerts.md#setting-up-generic-alerts)
-1. You can now visit **{cloud-gear}** **Operations > Alert Management** in your project's sidebar to [view a list](#alert-management-list) of alerts.
+1. You can now visit **{cloud-gear}** **Operations > Alerts** in your project's sidebar to [view a list](#alert-management-list) of alerts.
 
 ![Alert Management Toggle](img/alert_management_1_v13_1.png)
 
+## Populate Alert data
+
+To populate data, see the instructions for
+[customizing the payload](../integrations/generic_alerts.md) and making a
+request to the alerts endpoint.
+
 ## Alert Management severity
 
 Each level of alert contains a uniquely shaped and color-coded icon to help