diff options
| author | Daniele Procida <daniele@vurt.org> | 2024-10-22 20:10:25 +0200 |
|---|---|---|
| committer | Natalia <124304+nessita@users.noreply.github.com> | 2024-10-22 15:10:53 -0300 |
| commit | d9f37ac118e1717f831394d2be3b64c712d3b40e (patch) | |
| tree | ff1f6d1ab78599cb39a96981ec7a236b65973a94 /docs | |
| parent | 8efba533979b55ed8ca45c9dcadd098cc935821d (diff) | |
[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.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/howto/index.txt | 72 |
1 files 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 |