[New-bugs-announce] [issue20931] Confusing section title "New Expected Features for Python Implementations" in 3.4 What's New doc

[Ned Deily]

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 at python
components: Documentation
messages: 213617
nosy: docs at 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 <report at bugs.python.org>
<http://bugs.python.org/issue20931>
_______________________________________