(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.
I reworded to mention the coming changes regarding to PEP 484. The old writing which mention about arbitariness is moved to the end of the "function annotations" section as a warning.
