[New-bugs-announce] [issue23932] Tutorial section on function annotations is out of date re: PEP 484

[Zachary Ware]

New submission from Zachary Ware:

(Brought up by 'Tronster' on docs@)

https://docs.python.org/3/tutorial/controlflow.html#function-annotations

In light of the PEP 484 and its clear intentions for function annotations, the tutorial section on function annotations is out of date.  It should be updated to be clear that function annotations are intended for type hints, and that other uses are no longer encouraged.  The example should also use some built-in types in a manner consistent with PEP 484.

----------
assignee: docs at python
components: Documentation
messages: 240606
nosy: docs at python, gvanrossum, tim.golden, zach.ware
priority: normal
severity: normal
stage: needs patch
status: open
title: Tutorial section on function annotations is out of date re: PEP 484
versions: Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue23932>
_______________________________________