docs: rewrite new alert list panel docs (#50406)

Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>

docs/sources/visualizations/alert-list-panel.md

@@ -16,25 +16,29 @@ weight: 100
 
 # Alert list
 
-The Alert list allows you to display your dashboards alerts. You can configure the list to show current state or recent state changes. You can read more about alerts in [Alerts overview]({{< relref "../alerting/" >}}).
+Use Alert list to display your alerts. You can configure the list to show the current state or recent state changes. You can read more about alerts in [Grafana Alerting overview]({{< relref "../alerting/" >}}).
 
-{{< figure src="/static/img/docs/v45/alert-list-panel.png" max-width="850px" >}}
+{{< figure src="/static/img/docs/alert-list-panel/alert-list-panel.png" max-width="850px" >}}
 
-Use these settings to refine your visualization.
+Customize your visualization using the following settings.
 
 ## Options
 
-- **Show -** Choose whether the panel should display the current alert state or recent alert state changes.
+- **Group mode -** Choose between "Default grouping" to show alert instances grouped by their alert rule, or "Custom grouping" to group alert instances by a custom set of labels.
 - **Max Items -** Sets the maximum number of alerts to list.
 - **Sort order -** Select how to order the alerts displayed:
   - **Alphabetical (asc) -** Alphabetical order.
   - **Alphabetical (desc) -** Reverse alphabetical order.
   - **Importance -** By importance according to the following values, with 1 being the highest:
     - alerting: 1
+    - firing: 1
     - no_data: 2
     - pending: 3
     - ok: 4
     - paused: 5
+    - inactive: 5
+  - **Time (asc) -** Newest active alert instances first.
+  - **Time (desc) -** Oldest active alert instances first.
 - **Alerts from this dashboard -** Shows alerts only from the dashboard the alert list is in.
 
 ## Filter
@@ -42,17 +46,17 @@ Use these settings to refine your visualization.
 These options allow you to limit alerts shown to only those that match the query, folder, or tags you choose.
 
 - **Alert name -** Enter an alert name query.
-- **Dashboard title -** Enter a dashboard title query.
+- **Alert instance label -** Filter alert instances using label querying, ex: `{severity="critical", instance=~"cluster-us-.+"}`.
 - **Folder -** Select a folder. Only alerts from dashboards in the folder selected will be displayed.
-- **Dashboard tags -** Select one or more tags. Only alerts from dashboards with one or more of the tags will be displayed.
+- **Datasource -** Filter alerts from the selected data source.
 
 ## State filter
 
 Choose which alert states to display in this panel.
 
-- Ok
-- Paused
-- No data
-- Execution error
-- Alerting
+- Alerting / Firing
 - Pending
+- Inactive
+- No Data
+- Normal
+- Error