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: [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 | 72 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 50 insertions(+), 22 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,38 +1,66 @@
-===============
-"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
 
-   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
+   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
-   static-files/deployment
-   windows
-   writing-migrations
+   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
+
+   auth-remote-user
+   csrf
+   custom-management-commands
+   custom-file-storage
+
 .. seealso::
 
     The `Django community aggregator`_, where we aggregate content from the
-- 
cgit v1.3