devguide
devguide copied to clipboard
python
The Python developer's guide
> Also: should we think about moving this information to a different file altogether? This information isn't just relevant to core developers; it's relevant to any contributors. > > It's...
Sometimes we need to display command lines that are different in macos and windows. That's a feature in furo that lets you display such commands depends on the different environments,...
As discussed, I have moved the docs links to the Language column, have the names link to email addresses and GH usernames link to GH profiles. I've also added commas...
**Describe the enhancement or feature you'd like** The documentation for the bytecode interpreter has a variety of TODO's: https://devguide.python.org/internals/interpreter/: - Exception chaining > Other exception details. - The call stack...
On the landing page, we recommend running: `./python -m test -j3` Since most systems now are multicore, we should consider recommending: `./python -m test -j0` Tests on my machine several...
In the Documentation chapter, Style Guide / [Code Examples](https://devguide.python.org/documentation/style-guide/#code-examples) has >The ellipsis for the [sys.ps2](https://docs.python.org/3/library/sys.html#sys.ps2) secondary interpreter prompt should only be used sparingly, where it is necessary to clearly differentiate...
# Documentation Currently, the example for AC How-To is the method `_pickle.Pickler.dump`. I think it is not proper since it cannot cover all cases and makes readers confused. A more...
Suppose we have some lines that are close to 80 chars long ``` first text ... end first text. second text ... end second text. third text ... end third...
We have been following the [Diátaxis](https://diataxis.fr/) framework for a while now, with good results, however there are [no mentions of it](https://devguide.python.org/search/?q=Di%C3%A1taxis) in the devguide. We should add a short section...
There have been various discussions about doctesting interactive code examples in the python docs. The consensus has been that it is desirable that they pass. Indeed, CI currently has a...