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

A clean run of the configure script can take a while. Using configure cache (`./configure -C`) can help speed up edit-configure-build-test iterations considerably. Consider adding a sentence or two about...

enhancement
good first issue
guide-new content
topic-building python

**Describe the enhancement or feature you'd like** The documentation for the `dis` module provide a summary of what each opcode does. However, the summary is not enough to fully understand...

enhancement
needs: decision
guide-new content

As discussed in other issues (e.g. #1044 ) and PRs (e.g. #989 ), it would be nice to complete the migration of any not-already-covered relevant portions of Victor Stinner's [CPython...

enhancement
guide-new content
topic-building python

The [status key](https://devguide.python.org/versions/#status-key) for branches has lists of changes that can go in, and the lists look exclusive: > feature: > - new features, bugfixes, and security fixes are accepted....

enhancement
needs: decision
guide-edits

This was recently the source of confusion that led to a sequence of PRs and reverts that caused a documentation regression, e.g. see https://github.com/python/cpython/issues/100546 https://github.com/python/cpython/issues/98340 https://github.com/python/cpython/issues/91485 and some of the...

enhancement
needs: decision
guide-new content

Similar to [PEP 12](https://peps.python.org/12), the [reST primer](https://devguide.python.org/documentation/markup/#restructuredtext-primer) in the devguide duplicates the same information in the [Sphinx reST primer](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks), along with some bits specific to its particular context. In fact,...

enhancement
guide-edits

Followup to #998 (which would be implemented first, since it is more important and lower-hanging fruit). As [discussed] on PR #988 and at the Python Docs Community meeting, it would...

enhancement
guide-automation
topic-versions

As [discussed] on PR #988 and at the Python Docs Community meeting, the [Status of Python versions](https://devguide.python.org/versions/) table is missing an indication of the expected/actual cut-over point between bugfix and...

enhancement
guide-new content
guide-automation
topic-versions

This is a follow-up of #984: > There are a few broken links that I haven't touched yet: > > (developer-workflow/grammar: line 40) broken https://github.com/python/cpython/blob/main/Include/Python-ast.h > > (developer-workflow/grammar: line 33)...

bug
help wanted
guide-edits

Hi. Just a small enhancement proposal, as I don't think calling `make` with unbounded number of threads is desirable. Using `make -j` will start "infinite" number of jobs according to...

enhancement
needs: decision