From 8e34816d35c5f234530cd9e5eb8d400e062fea30 Mon Sep 17 00:00:00 2001
From: David Peter <mail@david-peter.de>
Date: Fri, 25 Sep 2026 17:27:52 +0200
Subject: [PATCH] Add a useful explicit receiver annotation example

---
 docs/guides/writing_stubs.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/guides/writing_stubs.rst b/docs/guides/writing_stubs.rst
index c9c642aba..7964566c9 100644
--- a/docs/guides/writing_stubs.rst
+++ b/docs/guides/writing_stubs.rst
@@ -657,6 +657,12 @@ Yes::
         @classmethod
         def create(cls) -> Self: ...
 
+    _T = TypeVar("_T")
+
+    class Box(Generic[_T]):
+        # This method is only available on boxes containing strings.
+        def upper(self: Box[str]) -> str: ...
+
 No::
 
     class Foo: