classification
Title: Source code has not always been forward-compatible
Type: Stage: patch review
Components: Documentation Versions:
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, mdk, willingc, zach.ware
Priority: normal Keywords: easy, patch

Created on 2019-06-20 17:22 by mdk, last changed 2019-06-20 19:55 by Kriyszig.

Pull Requests
URL Status Linked Edit
PR 14277 open Kriyszig, 2019-06-20 19:55
Messages (3)
msg346142 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2019-06-20 17:22
In Doc/library/parser.rst I can read:

The parse trees are not typically compatible from one version to another, whereas source code has always been forward-compatible.

But I don't think this is right, I think of print for example.

Maybe just remove ", whereas source code has always been forward-compatible" or rewrite it so say source is just more stable than parse trees?
msg346146 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2019-06-20 17:34
Perhaps just adding "within a major release series" after "forward-compatible" would be sufficient?
msg346159 - (view) Author: Carol Willing (willingc) * (Python committer) Date: 2019-06-20 19:01
"...though source code has usually been forward-compatible within a major release series."

Agree with your thoughts Julien and Zach. Perhaps remove "whereas" as well.
History
Date User Action Args
2019-06-20 19:55:35Kriyszigsetkeywords: + patch
stage: patch review
pull_requests: + pull_request14101
2019-06-20 19:01:27willingcsetnosy: + willingc
messages: + msg346159
2019-06-20 17:34:59zach.waresetnosy: + zach.ware
messages: + msg346146
2019-06-20 17:22:26mdkcreate