From 04d6edb38a5382e90b6f3071492ea1b1f6387f3f Mon Sep 17 00:00:00 2001
From: AgnesNM <agnesndutamwaniki@gmail.com>
Date: Wed, 27 Mar 2024 09:05:36 +0300
Subject: [PATCH] Include compound sorting information in docs

    Compound sorting is an existing feature on the Horizon dashboard.
    It is not obvious, however.
    This change should bring this feature to the attention of users.
    It should also guide users into how to use the feature when sorting.
    Horizon DataTables.

    DocImpact
    Closes-Bug: #1287418
    Implements: compound sorting

Change-Id: I810e863e01ca54f6751e1608e99ce97833597aff
---
 doc/source/contributor/ref/tables.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/source/contributor/ref/tables.rst b/doc/source/contributor/ref/tables.rst
index 2a6b942da7..057271dd7d 100644
--- a/doc/source/contributor/ref/tables.rst
+++ b/doc/source/contributor/ref/tables.rst
@@ -102,3 +102,19 @@ easier in your UI.
 .. autoclass:: DataTableView
 
 .. autoclass:: MultiTableView
+
+Additional Features
+===================
+Compound sorting
+----------------
+
+In the Horizon dashboard, most tables that
+display lists of resources (such as instances, volumes,
+images, etc.) support sorting by clicking on the column headers.
+
+To enable compound sorting, you can hold down the Shift key while
+clicking on additional column headers. This allows you to sort
+the table by multiple columns in the order you click them.
+
+An up or down arrow indicator shows next to the column headers
+you chose to sort by.