homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: https://docs.python.org/ should make a true 2.7.8 version available
Type: Stage: resolved
Components: Documentation Versions: Python 2.7
process
Status: closed Resolution: out of date
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Arfrever, benjamin.peterson, docs@python, lemburg, terry.reedy, zach.ware
Priority: normal Keywords:

Created on 2014年11月13日 14:28 by lemburg, last changed 2022年04月11日 14:58 by admin. This issue is now closed.

Messages (6)
msg231113 - (view) Author: Marc-Andre Lemburg (lemburg) * (Python committer) Date: 2014年11月13日 14:28
The documentation shown for Python 2.7.8 currently includes 2.7.9 parts, e.g. for the ssl modules (https://docs.python.org/2.7/library/ssl.html).
Since there were so many changes to the ssl module for 2.7.9 which are not available in 2.7.8, I think it would be good to be able to not only select "2.7.8" from the doc version drop-down, but to also really get that particular version of the documentation, and provide a separate "2.7.9" snapshop as well.
I tried https://docs.python.org/2.7.8/library/ssl.html, but that doesn't seem to exist.
PS: I'm not sure whether this is the right tracker to report this. Feel free to move it elsewhere.
msg231114 - (view) Author: Benjamin Peterson (benjamin.peterson) * (Python committer) Date: 2014年11月13日 14:36
There's https://docs.python.org/release/2.7.8/ 
msg231188 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2014年11月14日 21:35
New stuff is marked "New in version 2.7.9.", etc. The Idle chapter (reletively new in the Library Reference itself) has the same problem if new or quasi-new features in micro-releases are added to the doc before the release.
msg231190 - (view) Author: Marc-Andre Lemburg (lemburg) * (Python committer) Date: 2014年11月14日 21:55
On 14.11.2014 22:35, Terry J. Reedy wrote:
> New stuff is marked "New in version 2.7.9.", etc. The Idle chapter (reletively new in the Library Reference itself) has the same problem if new or quasi-new features in micro-releases are added to the doc before the release.
I know, but there are so many additions in the ssl module that it's
very difficult to tell what actually was part of earlier Python 2.7
releases.
I think best would be to link to the release URL Bejamin mentioned
for "2.7.8" and provide the trunk version as "2.7 (trunk)".
The same should probably be done for the other releases listed
in the selector.
msg231195 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2014年11月14日 23:18
I agree that "x.y.z" should be reserved for the frozen release version of the docs and that the current ongoing version should be "x.y (trunk)" or "x.y.z+". This was true without new features in a micro release, but did not matter so much. Leaving Idle aside, I am not sure how we should handle the new exception in other stdlib modules. There may or may not be more documented additions past 2.7.9.
msg367342 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2020年04月27日 01:32
As 2.7 is now EOL, I'm closing this issue.
History
Date User Action Args
2022年04月11日 14:58:10adminsetgithub: 67052
2020年04月27日 01:32:46zach.waresetstatus: open -> closed

nosy: + zach.ware
messages: + msg367342

resolution: out of date
stage: resolved
2014年11月15日 00:19:21Arfreversetnosy: + Arfrever
2014年11月14日 23:18:24terry.reedysetmessages: + msg231195
2014年11月14日 21:55:19lemburgsetmessages: + msg231190
2014年11月14日 21:35:29terry.reedysetnosy: + terry.reedy
messages: + msg231188
2014年11月13日 14:36:00benjamin.petersonsetnosy: + benjamin.peterson
messages: + msg231114
2014年11月13日 14:28:38lemburgcreate

AltStyle によって変換されたページ (->オリジナル) /