From 4ab2ee9508eb2eb992df1809b3d6dc996c23bb00 Mon Sep 17 00:00:00 2001
From: Sebastian Rittau <sebastian.rittau@zfutura.de>
Date: Wed, 22 Jul 2026 12:08:53 +0200
Subject: [PATCH] Recommend Never for return types as well

Per discussion in python/cpython#132941
---
 docs/guides/modernizing.rst | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/docs/guides/modernizing.rst b/docs/guides/modernizing.rst
index 05035b7bf..1ce82fc58 100644
--- a/docs/guides/modernizing.rst
+++ b/docs/guides/modernizing.rst
@@ -249,18 +249,14 @@ return types. For example, replace::
     from typing import NoReturn
 
     def f(x: int, y: NoReturn) -> None: ...
+    def g() -> NoReturn: ...
 
 with::
 
     from typing import Never  # or typing_extensions.Never
 
     def f(x: int, y: Never) -> None: ...
-
-But keep ``NoReturn`` for return types::
-
-    from typing import NoReturn
-
-    def f(x: int) -> NoReturn: ...
+    def g() -> Never: ...
 
 .. _modernizing-type-aliases: