Merge branch '229402-incident-severity-docs' into 'master'

Incident severity documentation

See merge request gitlab-org/gitlab!42225

doc/operations/incident_management/incidents.md

@@ -19,12 +19,17 @@ in your project's sidebar. The list contains the following metrics:
   or **All** above the incident list.
 - **Search** - The Incident list supports a simple free text search, which filters
   on the **Title** and **Incident** fields.
-- **Severity** - Severity of a particular incident. Can have one of the following values:
-  - `Critical - S1`
-  - `High - S2`
-  - `Medium - S3`
-  - `Low - S4`
-  - `Unknown`
+- **Severity** - Severity of a particular incident, which can be one of the following
+  values:
+  - **{severity-critical}** **Critical - S1**
+  - **{severity-high}** **High - S2**
+  - **{severity-medium}** **Medium - S3**
+  - **{severity-low}** **Low - S4**
+  - **{severity-unknown}** **Unknown**
+
+  NOTE: **Note:**
+  Editing incident severity on the incident details page was [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/229402) in GitLab 13.4.
+
 - **Incident** - The description of the incident, which attempts to capture the
   most meaningful data.
 - **Date created** - How long ago the incident was created. This field uses the
@@ -32,10 +37,10 @@ in your project's sidebar. The list contains the following metrics:
   tooltip depending on the user's locale.
 - **Assignees** - The user assigned to the incident.
 - **Published** - Displays a green check mark (**{check-circle}**) if the incident is published
-  to a [Status Page](./status_page.md).. **(ULTIMATE)**
+  to a [Status Page](status_page.md). **(ULTIMATE)**
 
 The Incident list displays incidents sorted by incident created date.
-([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/229534) to GitLab core in 13.3).)
+([Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/229534) to GitLab core in 13.3.)
 To see if a column is sortable, point your mouse at the header. Sortable columns
 display an arrow next to the column name.
 
@@ -97,7 +102,7 @@ If you have at least Developer [permissions](../../user/permissions.md), to crea
 
 - Navigate to **Issues > List** and click **Create Issue**.
 - Create a new issue using the `type` drop-down and select `Incident`.
-- The page will refresh and you will notice there are now only fields relevant to Incidents.
+- The page refreshes and the page only displays fields relevant to Incidents.
 
 ![Incident List Create](./img/new_incident_create_v13_4.png)