Update documentation for new template structure

Author: Simrayz

NOTES.md

@@ -4,6 +4,28 @@ This file documents changes to Argus that are relevant for operations,
 customizers and end-users.
 
 
+## Unreleased
+
+### Incident list filter UI refactoring
+
+The incident list filter UI has been refactored. The tabbed interface with
+"Filter Incidents" and "Update Incidents" tabs has been replaced with:
+
+- A collapsible filterbox (hidden by default, toggled with "Show/Hide filters")
+- A dynamic bulk actions bar that appears when rows are selected
+
+**Template changes for customizers:**
+
+The template `_incident_list_menubar.html` is now **deprecated** and will be
+removed in a future version. It currently acts as a shim that includes the new
+`_incident_toolbar.html` template.
+
+If you have overridden `_incident_list_menubar.html`, your override will still
+be loaded, but you should migrate to the new templates:
+
+- `_incident_toolbar.html`: Contains the full toolbar (filter controls + bulk actions)
+- `_filter_controls.html`: Contains the filter select dropdown, CRUD buttons, and show/hide toggle
+
 ## [2.6.0] - 2026-01-06
 
 This is a tiny release to finish up what was started at the end of 2025.

changelog.d/1693.changed.md

@@ -0,0 +1,5 @@
+Refactor incident list filter UI with collapsible filterbox and dynamic bulk actions bar.
+
+NOTES:
+The template `_incident_list_menubar.html` is deprecated; override `_incident_toolbar.html`
+or `_filter_controls.html` instead. See NOTES.md for details.

docs/development/howtos/htmx-frontend/override_templates.rst

@@ -71,10 +71,12 @@ Below is a list of templates that you may want to override for your use cases. T
 an extensive list, but can provide entry points or inspiration:
 
 * ``htmx/base.html``: add or remove nav links
-* ``htmx/incident/_incident_list_menubar.html``: remove the ``_filter_controls`` widget from the
-  filter box. This requires a full template override by copy/pasting the original template and modifying its content
-* ``htmx/incident/_incident_list_update_menu.html``: add custom action buttons to the "Update
-  Incidents" tab in this incident list
+* ``htmx/incident/_incident_list_menubar.html``: **deprecated**, use ``_incident_toolbar.html`` instead
+* ``htmx/incident/_incident_toolbar.html``: customize the toolbar containing filter controls and
+  bulk actions
+* ``htmx/incident/_filter_controls.html``: customize the filter select dropdown and related controls
+* ``htmx/incident/_incident_list_update_menu.html``: add custom action buttons to the bulk actions
+  menu
 * ``htmx/incident/cells/*.html``: customize how incident list column cells are rendered
 * ``htmx/incident/incident_detail.html``: customize the indicent details page
 * ``htmx/incident/incident_list.html``: add additional content to the incident list page, outside