[Python-checkins] bpo-28556: Update the opening note in typing docs (GH-16204)

Mon Sep 16 18:11:14 EDT 2019

https://github.com/python/cpython/commit/7076764992cd29e0e1f8b0ac2b92403e1a698aa6
commit: 7076764992cd29e0e1f8b0ac2b92403e1a698aa6
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019年09月16日T15:11:10-07:00
summary:
bpo-28556: Update the opening note in typing docs (GH-16204)
This PR replaces the old note mentioning that `typing` is a provisional module with a new one mentioning types are not enforced at runtime. I am not sure if there was any official announcement about making `typing` non-provisional, but _de-facto_ no new features were added during Python 3.7, and no backwards incompatible changes were made except for few small things that were considered bugs.
(cherry picked from commit 81528ba2e81c39f4d6bca5b785e818c7d08b8501)
Co-authored-by: Ivan Levkivskyi <levkivskyi at gmail.com>
files:
M Doc/library/typing.rst

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 12efde131657..f4d1b2404328 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -10,10 +10,9 @@
 
 .. note::
 
- The typing module has been included in the standard library on a
- :term:`provisional basis <provisional api>`. New features might
- be added and API may change even between minor releases if deemed
- necessary by the core developers.
+ The Python runtime does not enforce function and variable type annotations.
+ They can be used by third party tools such as type checkers, IDEs, linters,
+ etc.
 
 --------------
 
