Skip to content

Commit dd0a116

Browse files
authored
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.
1 parent df6013b commit dd0a116

File tree

1 file changed

+50
-22
lines changed

1 file changed

+50
-22
lines changed

docs/howto/index.txt

Lines changed: 50 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,66 @@
1-
===============
2-
"How-to" guides
3-
===============
1+
=============
2+
How-to guides
3+
=============
44

5-
Here you'll find short answers to "How do I....?" types of questions. These
6-
how-to guides don't cover topics in depth -- you'll find that material in the
7-
:doc:`/topics/index` and the :doc:`/ref/index`. However, these guides will help
8-
you quickly accomplish common tasks.
5+
Practical guides covering common tasks and problems.
6+
7+
Models, data and databases
8+
==========================
99

1010
.. toctree::
1111
:maxdepth: 1
1212

13-
auth-remote-user
14-
csrf
15-
custom-management-commands
16-
custom-model-fields
17-
custom-lookups
18-
custom-template-backend
19-
custom-template-tags
20-
custom-file-storage
21-
deployment/index
22-
upgrade-version
23-
error-reporting
2413
initial-data
2514
legacy-databases
26-
logging
15+
custom-model-fields
16+
writing-migrations
17+
custom-lookups
18+
19+
Templates and output
20+
====================
21+
22+
.. toctree::
23+
:maxdepth: 1
24+
2725
outputting-csv
2826
outputting-pdf
2927
overriding-templates
28+
custom-template-backend
29+
custom-template-tags
30+
31+
Project configuration and management
32+
====================================
33+
34+
.. toctree::
35+
:maxdepth: 1
36+
3037
static-files/index
31-
static-files/deployment
32-
windows
33-
writing-migrations
38+
logging
39+
error-reporting
3440
delete-app
3541

42+
Installing, deploying and upgrading
43+
===================================
44+
45+
.. toctree::
46+
:maxdepth: 1
47+
48+
upgrade-version
49+
windows
50+
deployment/index
51+
static-files/deployment
52+
53+
Other guides
54+
============
55+
56+
.. toctree::
57+
:maxdepth: 1
58+
59+
auth-remote-user
60+
csrf
61+
custom-management-commands
62+
custom-file-storage
63+
3664
.. seealso::
3765

3866
The `Django community aggregator`_, where we aggregate content from the

0 commit comments

Comments
 (0)