@@ -243,8 +243,8 @@ OTHER TOPICS
243
243
244
244
Generally use PEP 8.
245
245
246
- import
247
- ------
246
+ import statements
247
+ -----------------
248
248
Put imports at the top, unless there is a good reason otherwise.
249
249
PEP 8 says to group stdlib, 3rd-party dependencies, and package imports.
250
250
For idlelib, the groups are general stdlib, tkinter, and idlelib.
@@ -259,3 +259,24 @@ htest function def or "if __name__ == '__main__'" clause.
259
259
Within module imports like "from idlelib.mod import class" may cause
260
260
circular imports to deadlock. Even without this, circular imports may
261
261
require at least one of the imports to be delayed until a function call.
262
+
263
+ What's New entries
264
+ ------------------
265
+
266
+ Repository directory Doc/whatsnew/ has a file 3.n.rst for each 3.n
267
+ Python version. For the first entry in each file, add subsection
268
+ 'IDLE and idlelib', in alphabetical position, to the 'Improved Modules'
269
+ section. For the rest of cpython, entries to 3.(n+1).rst begin with
270
+ the release of 3.n.0b1. For IDLE, entries for features backported from
271
+ 'main' to '3.n' during its beta period do not got in 3.(n+1).rst. The
272
+ latter usually gets its first entry during the 3.n.0 candidate period
273
+ or after the 3.n.0 release.
274
+
275
+ When, as per PEP 434, feature changes are backported, entries are placed
276
+ in the 3.n.rst file *in the main branch* for each Python version n that
277
+ gets the backport. (Note: the format of entries have varied between
278
+ versions.) Add a line "New in 3.n maintenance releases." before the
279
+ first back-ported feature after 3.n.0 is released. Since each older
280
+ version file gets a different number of backports, it is easiest to
281
+ make a separate PR for each file and label it with the backports
282
+ needed.
0 commit comments