devguide
devguide copied to clipboard
The Python developer's guide
Fixes #1244 I tried to update the references of the core development discussion. Need reviews. ---- ๐ Documentation preview ๐: https://cpython-devguide--1249.org.readthedocs.build/
This is related to https://github.com/python/cpython/issues/64490 ---- ๐ Documentation preview ๐: https://cpython-devguide--1277.org.readthedocs.build/
**Describe the bug** A clear and concise description of what the bug is. 1. Go to https://devguide.python.org/ and search for "diataxis" **Actual behavior** No results. **Expected behavior** Find results to...
We need a better reference for the Argument Clinic DSL: - legal syntax for the "function name" line - legal syntax for parameter lines - legal syntax for docstrings
We need a good reference for all Argument Clinic directives (`@getter`, `output`, etc.). Some of the directives accept one or more parameters; perhaps we can use typical CLI documentation for...
There is already a reference for the converter base class; we also need one for the return converter base class.
# Documentation The [tutorial for Argument Clinic](https://devguide.python.org/development-tools/clinic/#tutorial) in the devguide contains an outdated section. It still describes the early implementation that used to generate calls to PyArg_ParseTuple*() functions. This is...
The python-dev mailing list has been retired and archived as read-only, as most core discussion takes place on Discourse instead. * https://mail.python.org/mailman3/lists/python-dev.python.org/ * https://mail.python.org/archives/list/[email protected]/thread/PDRLCB6CNLQAFVGPTLXL5QV6SVQDPCCV/ The devguide needs updating in a...
Follow-up for ...: - https://github.com/python/cpython/issues/90039. If cross-compiling broken, or not recommended, we should note that in the devguide.
> I think having a concise list is good, but if we want to elaborate more and clarify we could also provide some examples. An example for this is "a...