docs: drop development-journal language from docstrings/comments

Remove references to PR numbers, internal scratch notes, and design-spike
shorthand that won't make sense to a fresh reader of the codebase.

Author: maxisbey

src/mcp/server/_typed_request.py

@@ -1,13 +1,14 @@
-"""Shape-2 typed ``send_request`` for server-to-client requests.
+"""Typed ``send_request`` for server-to-client requests.
 
 `TypedServerRequestMixin` provides a typed `send_request(req) -> Result` over
 the host's raw `Outbound.send_raw_request`. Spec server-to-client request types
 have their result type inferred via per-type overloads; custom requests pass
 ``result_type=`` explicitly.
 
-A `HasResult[R]` protocol (one generic signature, mapping declared on the
-request type) is the cleaner long-term shape — see FOLLOWUPS.md. This per-spec
-overload set is used for now to avoid touching `mcp.types`.
+If the spec's request set grows substantially, consider declaring the result
+mapping on the request types themselves (a ``__mcp_result__`` ClassVar read via
+a structural protocol) so this overload ladder doesn't need maintaining
+per-host-class.
 """
 
 from typing import Any, TypeVar, overload

src/mcp/server/connection.py

@@ -53,7 +53,7 @@ def __init__(self, outbound: Outbound, *, has_standalone_channel: bool) -> None:
         self.protocol_version: str | None = None
         self.initialized: anyio.Event = anyio.Event()
         # TODO: make this generic (Connection[StateT]) once connection_lifespan
-        # wiring lands in ServerRunner — see FOLLOWUPS.md.
+        # wiring lands in ServerRunner.
         self.state: Any = None
 
     async def send_raw_request(
@@ -124,7 +124,7 @@ def check_capability(self, capability: ClientCapabilities) -> bool:
         Returns ``False`` if ``initialize`` hasn't completed yet.
         """
         # TODO: redesign — mirrors v1 ServerSession.check_client_capability
-        # verbatim for parity. See FOLLOWUPS.md.
+        # verbatim for parity.
         if self.client_capabilities is None:
             return False
         have = self.client_capabilities

src/mcp/server/context.py

@@ -42,8 +42,8 @@ class Context(BaseContext[TransportT], PeerMixin, TypedServerRequestMixin, Gener
     and `TypedServerRequestMixin` (typed ``send_request(req) -> Result``). Adds
     ``lifespan`` and ``connection``.
 
-    Constructed by `ServerRunner` (PR4) per inbound request and handed to the
-    user's handler.
+    Constructed by `ServerRunner` per inbound request and handed to the user's
+    handler.
     """
 
     def __init__(

src/mcp/shared/context.py

@@ -28,8 +28,8 @@
 class BaseContext(Generic[TransportT]):
     """Per-request context wrapping a `DispatchContext`.
 
-    `ServerRunner` (PR4) constructs one per inbound request and passes it to
-    the user's handler.
+    `ServerRunner` constructs one per inbound request and passes it to the
+    user's handler.
     """
 
     def __init__(self, dctx: DispatchContext[TransportT], meta: RequestParamsMeta | None = None) -> None: