Alex feedback

Author: JelleZijlstra

Lib/typing.py

@@ -2687,7 +2687,7 @@ def _overload_dummy(*args, **kwds):
 def overload(func):
     """Decorator for overloaded functions/methods.
 
-    In a stub file, place two or more stub definitions for the same
+    In a non-stub file, place two or more stub definitions for the same
     function in a row, each decorated with @overload, followed
     with an implementation.  The implementation should *not*
     be decorated with @overload::
@@ -2701,8 +2701,8 @@ def utf8(value: str) -> bytes: ...
         def utf8(value):
             ...  # implementation goes here
 
-    In a stub file or in a Protocol definition, the implementation
-    should be omitted::
+    In a stub file or in an abstract method (for example, in a Protocol definition),
+    the implementation may be omitted::
 
         @overload
         def utf8(value: None) -> None: ...
@@ -2711,7 +2711,6 @@ def utf8(value: bytes) -> bytes: ...
         @overload
         def utf8(value: str) -> bytes: ...
 
-
     The overloads for a function can be retrieved at runtime using the
     get_overloads() function.
     """