Update the documentation howto index page and group docs into 3 logic… · python/cpython@a26d27e (original) (raw)
`@@ -2,16 +2,14 @@
`
2
2
` Python HOWTOs
`
3
3
`***************
`
4
4
``
5
``
`-
Python HOWTOs are documents that cover a single, specific topic,
`
6
``
`-
and attempt to cover it fairly completely. Modelled on the Linux
`
7
``
`-
Documentation Project's HOWTO collection, this collection is an
`
``
5
`+
Python HOWTOs are documents that cover a specific topic in-depth.
`
``
6
`+
Modeled on the Linux Documentation Project's HOWTO collection, this collection is an
`
8
7
`effort to foster documentation that's more detailed than the
`
9
8
`Python Library Reference.
`
10
9
``
11
``
`-
Currently, the HOWTOs are:
`
12
``
-
13
10
`.. toctree::
`
14
11
`:maxdepth: 1
`
``
12
`+
🥷
`
15
13
``
16
14
`cporting.rst
`
17
15
`curses.rst
`
`@@ -35,3 +33,32 @@ Currently, the HOWTOs are:
`
35
33
`timerfd.rst
`
36
34
`mro.rst
`
37
35
``
``
36
`+
General:
`
``
37
+
``
38
`` +
- :ref:
annotations-howto
``
``
39
`` +
- :ref:
argparse-tutorial
``
``
40
`` +
- :ref:
descriptorhowto
``
``
41
`` +
- :ref:
enum-howto
``
``
42
`` +
- :ref:
functional-howto
``
``
43
`` +
- :ref:
ipaddress-howto
``
``
44
`` +
- :ref:
logging-howto
``
``
45
`` +
- :ref:
logging-cookbook
``
``
46
`` +
- :ref:
regex-howto
``
``
47
`` +
- :ref:
sortinghowto
``
``
48
`` +
- :ref:
unicode-howto
``
``
49
`` +
- :ref:
urllib-howto
``
``
50
+
``
51
`+
Advanced development:
`
``
52
+
``
53
`` +
- :ref:
curses-howto
``
``
54
`` +
- :ref:
isolating-extensions-howto
``
``
55
`` +
- :ref:
python_2.3_mro
``
``
56
`` +
- :ref:
socket-howto
``
``
57
`` +
- :ref:
timerfd-howto
``
``
58
`` +
- :ref:
cporting-howto
``
``
59
+
``
60
`+
Debugging and profiling:
`
``
61
+
``
62
`` +
- :ref:
gdb
``
``
63
`` +
- :ref:
instrumentation
``
``
64
`` +
- :ref:
perf_profiling
``