From d9f37ac118e1717f831394d2be3b64c712d3b40e Mon Sep 17 00:00:00 2001
From: Daniele Procida <daniele@vurt.org>
Date: Tue, 22 Oct 2024 20:10:25 +0200
Subject: [PATCH] [5.1.x] Restructured how-to docs landing page.

Previously, this was a bare list of sub-pages, not in any discernible
order, and hard to parse.

Now the sub-pages are grouped in sections by topic. It's unlikely to be
the final word on how this material is arranged, but it's a clear
improvement on the existing arrangement and provides a good basis for
next steps.
Backport of dd0a116b93c40f9febf0e09614ad666af1191744 from main.
---
 docs/howto/index.txt | 78 ++++++++++++++++++++++++++++++--------------
 1 file changed, 53 insertions(+), 25 deletions(-)

diff --git a/docs/howto/index.txt b/docs/howto/index.txt
index 0034032ce2..d799ca7906 100644
--- a/docs/howto/index.txt
+++ b/docs/howto/index.txt
@@ -1,11 +1,57 @@
-===============
-"How-to" guides
-===============
+=============
+How-to guides
+=============
 
-Here you'll find short answers to "How do I....?" types of questions. These
-how-to guides don't cover topics in depth -- you'll find that material in the
-:doc:`/topics/index` and the :doc:`/ref/index`. However, these guides will help
-you quickly accomplish common tasks.
+Practical guides covering common tasks and problems.
+
+Models, data and databases
+==========================
+
+.. toctree::
+   :maxdepth: 1
+
+   initial-data
+   legacy-databases
+   custom-model-fields
+   writing-migrations
+   custom-lookups
+
+Templates and output
+====================
+
+.. toctree::
+   :maxdepth: 1
+
+   outputting-csv
+   outputting-pdf
+   overriding-templates
+   custom-template-backend
+   custom-template-tags
+
+Project configuration and management
+====================================
+
+.. toctree::
+   :maxdepth: 1
+
+   static-files/index
+   logging
+   error-reporting
+   delete-app
+
+Installing, deploying and upgrading
+===================================
+
+.. toctree::
+   :maxdepth: 1
+
+   upgrade-version
+   windows
+   deployment/index
+   static-files/deployment
+
+Other guides
+============
 
 .. toctree::
    :maxdepth: 1
@@ -13,25 +59,7 @@ you quickly accomplish common tasks.
    auth-remote-user
    csrf
    custom-management-commands
-   custom-model-fields
-   custom-lookups
-   custom-template-backend
-   custom-template-tags
    custom-file-storage
-   deployment/index
-   upgrade-version
-   error-reporting
-   initial-data
-   legacy-databases
-   logging
-   outputting-csv
-   outputting-pdf
-   overriding-templates
-   static-files/index
-   static-files/deployment
-   windows
-   writing-migrations
-   delete-app
 
 .. seealso::