devguide icon indicating copy to clipboard operation
devguide copied to clipboard

The Python developer's guide

Results 207 devguide issues
Sort by recently updated
recently updated
newest added

Fixes #1244 I tried to update the references of the core development discussion. Need reviews. ---- ๐Ÿ“š Documentation preview ๐Ÿ“š: https://cpython-devguide--1249.org.readthedocs.build/

needs: PR update

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...

bug

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

enhancement
guide-edits

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...

enhancement
guide-edits

There is already a reference for the converter base class; we also need one for the return converter base class.

enhancement
guide-edits

# 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...

enhancement
topic-dev process
guide-edits

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...

help wanted
good first issue
guide-edits

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...

good first issue