bpo-46120: State that | is preferred over Union (GH-30222)

sobolevn · merwok · gvanrossum · web-flow · commit 1b30660c3b40 · 2021-12-24T13:36:09.000-08:00
Co-authored-by: Éric &lt;merwok@netwok.org&gt;
Co-authored-by: Guido van Rossum &lt;gvanrossum@gmail.com&gt;
diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
@@ -625,7 +625,7 @@ These can be used as types in annotations using ``[]``, each having a unique syn
 
    Union type; ``Union[X, Y]`` is equivalent to ``X | Y`` and means either X or Y.
 
-   To define a union, use e.g. ``Union[int, str]`` or the shorthand ``int | str``.  Details:
+   To define a union, use e.g. ``Union[int, str]`` or the shorthand ``int | str``. Using that shorthand is recommended. Details:
 
    * The arguments must be types and there must be at least one.
 
diff --git a/Misc/NEWS.d/next/Documentation/2021-12-21-12-45-57.bpo-46120.PE0DmJ.rst b/Misc/NEWS.d/next/Documentation/2021-12-21-12-45-57.bpo-46120.PE0DmJ.rst
@@ -0,0 +1 @@
+State that ``|`` is preferred for readability over ``Union`` in the :mod:`typing` docs.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+State that ``\|`` is preferred for readability over ``Union`` in the :mod:`typing` docs.