]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
[3.11] Docs: Argument Clinic: Add Background and Tutorial top-level sections (GH...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Fri, 21 Jul 2023 06:32:56 +0000 (23:32 -0700)
committerGitHub <noreply@github.com>
Fri, 21 Jul 2023 06:32:56 +0000 (08:32 +0200)
commit0a57620887f9877398c44062539da3e58235f0e6
treefb05c59bc59c9f0ffe7766c14fdb2373776980b2
parent951b08c5006fe6a7daff4a9769964b4017a9b754
[3.11] Docs: Argument Clinic: Add Background and Tutorial top-level sections (GH-106904) (#106946)

Add Background as a toplevel section with the following subsections:

- Background
  - The goals of Argument Clinic
  - Basic concepts and usage

Rename "Converting your first function" to Tutorial.

Add anchors for Background, Tutorial, and How-to Guides:

- :ref:`clinic-background`
- :ref:`clinic-tutorial`
- :ref:`clinic-howtos`

Link to these from within the Abstract.

Break the compatibility paragraph out of Abstract and make it a note.
(cherry picked from commit 81861fd90b4ae981e7881cd03a3c370713063525)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Doc/howto/clinic.rst