Skip to content

Commit

Permalink
pythongh-95251: IDLE - Add What's New section to README
Browse files Browse the repository at this point in the history
Document what I (TJR) currently do for 3.10/3.11.
  • Loading branch information
terryjreedy committed Aug 4, 2022
1 parent 44f1f63 commit 276ddc6
Showing 1 changed file with 20 additions and 2 deletions.
22 changes: 20 additions & 2 deletions Lib/idlelib/README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -243,8 +243,8 @@ OTHER TOPICS

Generally use PEP 8.

import
------
import statements
-----------------
Put imports at the top, unless there is a good reason otherwise.
PEP 8 says to group stdlib, 3rd-party dependencies, and package imports.
For idlelib, the groups are general stdlib, tkinter, and idlelib.
Expand All @@ -259,3 +259,21 @@ htest function def or "if __name__ == '__main__'" clause.
Within module imports like "from idlelib.mod import class" may cause
circular imports to deadlock. Even without this, circular imports may
require at least one of the imports to be delayed until a function call.

What's New entries
------------------

Repository directory Doc/whatsnew/ has a file 3.n.rst for each 3.n
Python version. For the first entry in each file, add subsection
'idlelib and IDLE', in alphabetical position, to the 'Improved Modules'
section. The first entry to '3.(n+1).rst is the first feature or
feature change that will not appear in the 3.n.0 release.

When, as usual, feature changes are backported, entries are placed in
the 3.n.rst file *in the main branch* for each Python version n that
gets the feature. (Note: the format of entries have varied between
versions.) Add a line "New in 3.n maintenance releases." before the
first back-ported feature after 3.n.0 is released. Since each older
version file gets a different number of backports, it is easiest to
make a separate PR for each file and label it with the backports
needed.

0 comments on commit 276ddc6

Please sign in to comment.