[2023-01-27]: Sorting across all layouts on Projects (#34141)

Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com>

content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-board-layout.md

@@ -48,6 +48,22 @@ In the board layout, you can can choose which columns to display. The available
 
 {% endif %}
 
+{% ifversion projects-v2-consistent-sorting %}
+
+## Sorting by field values
+
+You can sort items by a field value.
+
+{% note %}
+
+**Note:** When a board is sorted, you cannot manually reorder items within a column. You can continue to move items from column to column.
+
+{% endnote %}
+
+{% data reusables.projects.customize.sort %}
+
+{% endif %}
+
 {% ifversion projects-v2-numeric-summary %}
 
 ## Showing the sum of a number field

content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-roadmap-layout.md

@@ -46,6 +46,21 @@ You can choose the density of items on your roadmap. You can zoom in to show one
 
   ![Screenshot showing the zoom level options](/assets/images/help/projects-v2/roadmap-zoom-menu.png)
 
+{% ifversion projects-v2-consistent-sorting %}
+
+## Sorting by field values
+
+You can sort items by a field value.
+
+{% note %}
+
+**Note:** When a roadmap is sorted, you cannot manually reorder rows.
+
+{% endnote %}
+
+{% data reusables.projects.customize.sort %}
+
+{% endif %}
 
 ## Showing and hiding fields
 

content/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/customizing-the-table-layout.md

@@ -61,17 +61,7 @@ You can sort items by a field value.
 
 {% endnote %}
 
-{% data reusables.projects.open-view-menu %}
-1. Click **Sort**.
-   ![Screenshot showing the sort menu item](/assets/images/help/projects-v2/sort-menu-item.png)
-1. Click the field you want to sort by.
-   ![Screenshot showing the sort menu](/assets/images/help/projects-v2/sort-menu.png)
-2. Optionally, to change the direction of the sort, click {% octicon "sort-desc" aria-label="the sort icon" %}.
-   ![Screenshot showing sort order option](/assets/images/help/projects-v2/sort-order.png)
-3. Optionally, to remove a sort, click {% octicon "x" aria-label="the x icon" %} **No sorting** at the bottom of the list.
-   ![Screenshot showing "no sorting"](/assets/images/help/projects-v2/no-sorting.png)
-
-Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Sort by."
+{% data reusables.projects.customize.sort %}
 
 {% ifversion projects-v2-numeric-summary %}
 

data/features/projects-v2-consistent-sorting.yml

@@ -0,0 +1,6 @@
+# Issue 9056
+# Ability to sort roadmaps and boards too
+versions:
+  fpt: '*'
+  ghec: '*'
+  ghes: '>=3.9'

data/reusables/projects/customize/sort.md

@@ -0,0 +1,11 @@
+{% data reusables.projects.open-view-menu %}
+1. Click **Sort**.
+   ![Screenshot showing the sort menu item](/assets/images/help/projects-v2/sort-menu-item.png)
+1. Click the field you want to sort by.
+   ![Screenshot showing the sort menu](/assets/images/help/projects-v2/sort-menu.png)
+1. Optionally, to change the direction of the sort, click {% octicon "sort-desc" aria-label="the sort icon" %}.
+   ![Screenshot showing sort order option](/assets/images/help/projects-v2/sort-order.png)
+1. Optionally, to remove a sort, click {% octicon "x" aria-label="the x icon" %} **No sorting** at the bottom of the list.
+   ![Screenshot showing "no sorting"](/assets/images/help/projects-v2/no-sorting.png)
+
+Alternatively, open the project command palette by pressing {% data variables.projects.command-palette-shortcut %} and start typing "Sort by."