classification
Title: documentation: recommend Python 3 over 2 in faq
Type: Stage: patch review
Components: Documentation Versions: Python 3.8, Python 3.7, Python 3.6, Python 2.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Mariatta, abcdef, docs@python, gus.goulart, miss-islington, taleinat, xtreak
Priority: normal Keywords: patch

Created on 2018-07-24 01:55 by abcdef, last changed 2018-10-12 12:18 by taleinat.

Pull Requests
URL Status Linked Edit
PR 9796 merged gus.goulart, 2018-10-11 03:10
PR 9815 merged miss-islington, 2018-10-12 09:16
PR 9816 merged miss-islington, 2018-10-12 09:17
PR 9817 merged miss-islington, 2018-10-12 09:17
PR 9821 open taleinat, 2018-10-12 12:18
Messages (7)
msg322273 - (view) Author: (abcdef) Date: 2018-07-24 01:55
FAQ "How stable is Python" https://docs.python.org/3/faq/general.html#how-stable-is-python" states

"There are two recommended production-ready versions at this point in time, because at the moment there are two branches of stable releases: 2.x and 3.x. Python 3.x may be less useful than 2.x, since currently there is more third party software available for Python 2 than for Python 3. Python 2 code will generally not run unchanged in Python 3."

According to git blame, this is from 2009. Could we change this to recommend Python 3 over Python 2 now?
msg322274 - (view) Author: Mariatta Wijaya (Mariatta) * (Python committer) Date: 2018-07-24 02:03
Yep. Please propose a patch.

I think this should be updated even for Python 2.7 docs, which is nearing EOL.
msg327507 - (view) Author: Gus Goulart (gus.goulart) * Date: 2018-10-11 03:17
Thanks for pointing that out. If you don't mind, I have created a PR to address your requests.
msg327576 - (view) Author: Tal Einat (taleinat) * (Python committer) Date: 2018-10-12 09:16
New changeset 4505f65ae7807f2420ed14d4f060e7cd5c4039d3 by Tal Einat (Gus Goulart) in branch 'master':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/4505f65ae7807f2420ed14d4f060e7cd5c4039d3
msg327581 - (view) Author: miss-islington (miss-islington) Date: 2018-10-12 12:06
New changeset d4ed8809ddfaa23fe5edf2987c03afc32f5576c0 by Miss Islington (bot) in branch '3.7':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/d4ed8809ddfaa23fe5edf2987c03afc32f5576c0
msg327582 - (view) Author: miss-islington (miss-islington) Date: 2018-10-12 12:06
New changeset 86cfac47cf736fae90a617959288ccade18fd07e by Miss Islington (bot) in branch '3.6':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/86cfac47cf736fae90a617959288ccade18fd07e
msg327583 - (view) Author: miss-islington (miss-islington) Date: 2018-10-12 12:06
New changeset 6198976ec807cf3b658e902fd63db88a3ac99b8c by Miss Islington (bot) in branch '2.7':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/6198976ec807cf3b658e902fd63db88a3ac99b8c
History
Date User Action Args
2018-10-12 12:18:38taleinatsetpull_requests: + pull_request9198
2018-10-12 12:06:20miss-islingtonsetmessages: + msg327583
2018-10-12 12:06:16miss-islingtonsetmessages: + msg327582
2018-10-12 12:06:12miss-islingtonsetnosy: + miss-islington
messages: + msg327581
2018-10-12 09:17:10miss-islingtonsetpull_requests: + pull_request9195
2018-10-12 09:17:02miss-islingtonsetpull_requests: + pull_request9194
2018-10-12 09:16:55miss-islingtonsetpull_requests: + pull_request9193
2018-10-12 09:16:54taleinatsetmessages: + msg327576
2018-10-11 03:17:13gus.goulartsetnosy: + taleinat, gus.goulart
messages: + msg327507
2018-10-11 03:10:54gus.goulartsetkeywords: + patch
stage: needs patch -> patch review
pull_requests: + pull_request9180
2018-07-31 18:07:05xtreaksetnosy: + xtreak
2018-07-24 02:03:37Mariattasetversions: + Python 2.7, Python 3.6, Python 3.7
nosy: + Mariatta

messages: + msg322274

stage: needs patch
2018-07-24 01:55:28abcdefcreate