bpo-36896: Clarify that some types constructors are unstable (GH-13271)

diff --git a/Doc/library/types.rst b/Doc/library/types.rst
index e629c2935f27f4a31550437d8dc50fd79e823a99..a21fb44dda5dec1d11d0e9e45e4a178ed4890a6d 100644 (file)
--- a/Doc/library/types.rst
+++ b/Doc/library/types.rst
@@ -98,6 +98,9 @@ the types that arise only incidentally during processing such as the
 Typical use of these names is for :func:`isinstance` or
 :func:`issubclass` checks.
 
+
+If you instantiate any of these types, note that signatures may vary between Python versions.
+
 Standard names are defined for the following types:
 
 .. data:: FunctionType

diff --git a/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst b/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst
new file mode 100644 (file)
index 0000000..d75fcca
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst
@@ -0,0 +1,2 @@
+Clarify that some types have unstable constructor signature between Python
+versions.