New submission from Ned Deily: The 3.4 What's New document has a section entitled "New expected features for Python implementations", a title not found in previous releases. I believe that the intention is to document features expected to be implemented by all Python implementations, including non CPython ones, when they claim to support 3.4. However, I think the wording is likely to be misunderstood by most readers as meaning "features expected to be in the 3.4 release (including CPython)", leaving a question in their minds as to whether all of the described features are actually in the 3.4 release. On the other hand, AFAIK, the standard documentation set has never attempted to document all of the deviations from CPython for each particular non-CPython implementation; if the wording is understood as intended, it could be construed as implying something that isn't true. So, under either reading, the wording can be misleading. I think it should just be removed or reworded as "New Features".
http://docs.python.org/3.4/whatsnew/3.4.html#summary-release-highlights http://docs.python.org/3.4/whatsnew/3.4.html#new-expected-features-for-python-implementations ---------- assignee: docs@python components: Documentation messages: 213617 nosy: docs@python, larry, ncoghlan, ned.deily priority: normal severity: normal status: open title: Confusing section title "New Expected Features for Python Implementations" in 3.4 What's New doc versions: Python 3.4 _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue20931> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
