Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity
cpython/Doc/howto
History
Erlend E. Aasland 81861fd90b
Docs: Argument Clinic: Add Background and Tutorial top-level sections (#106904) 
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.

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
 		2023-07-21 08:05:41 +02:00
..
annotations.rst gh-99535: Add test for inheritance of annotations and update documentation (#99990) 2022-12-24 12:07:14 -08:00
argparse.rst gh-101100: Fix Sphinx warnings in `argparse` module (#103289) 2023-04-24 15:36:32 -06:00
clinic.rst Docs: Argument Clinic: Add Background and Tutorial top-level sections (#106904) 2023-07-21 08:05:41 +02:00
cporting.rst gh-91838: Use HTTPS links in docs for resources which redirect to HTTPS (GH-95527) 2022-08-04 10:13:49 +03:00
curses.rst gh-101100: Fix Sphinx warnings in `curses` and `curses.ascii` modules (#103457) 2023-05-02 23:09:04 -06:00
descriptor.rst Descriptor HowTo: Update to include attributes added in Python 3.10 (GH-103666) 2023-04-22 08:29:40 -05:00
enum.rst gh-105332: [Enum] Fix unpickling flags in edge-cases (GH-105348) 2023-06-08 11:40:15 -07:00
functional.rst GH-103484: Fix broken links reported by linkcheck (#103608) 2023-04-22 08:24:47 -06:00
index.rst gh-96143: Allow Linux perf profiler to see Python calls (GH-96123) 2022-08-30 10:11:18 -07:00
instrumentation.rst Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551) 2022-07-05 11:16:10 +02:00
ipaddress.rst bpo-44740: Make minor edits to lowercasing "internet" and "web". (GH-27385) 2021-07-27 10:57:52 +02:00
isolating-extensions.rst gh-102304: doc: Add links to Stable ABI and Limited C API (#105345) 2023-06-06 08:40:32 +00:00
logging-cookbook.rst gh-102582: Fix invalid JSON in Doc/howto/logging-cookbook.rst (GH-102635) 2023-03-29 09:52:53 +01:00
logging.rst gh-103960: Dark mode: invert image brightness (#103983) 2023-05-10 16:46:37 +03:00
logging_flow.png Optimize images by IMGbot (GH-21348) 2022-02-04 15:49:43 +09:00
perf_profiling.rst gh-103295: expose API for writing perf map files (#103546) 2023-05-21 11:12:24 +01:00
pyporting.rst GH-103484: Fix redirected permanently URLs (#104001) 2023-05-02 09:34:44 +03:00
regex.rst gh-97681: Remove Tools/demo/ directory (#97682) 2022-10-03 17:09:02 +02:00
sockets.rst Doc: Update references and examples of old, unsupported OSes and uarches (GH-92791) 2022-06-09 15:55:06 +02:00
sorting.rst Fix typo in sorting HOWTO (#98888) 2022-10-31 12:58:13 -05:00
unicode.rst gh-98763: Prefer "python" over "python3" for command line examples in docs. (#98761) 2023-01-11 15:35:41 +05:30
urllib2.rst howto/urllib2: remove link to an outdated french translation (GH-104193) 2023-05-22 15:03:29 +02:00