docs: address review feedback on missing docstrings

Author: nightcityblade

docs/source/reference-io.rst

@@ -218,7 +218,6 @@ abstraction.
 
 .. autoclass:: SocketStream
    :members:
-   :undoc-members:
    :show-inheritance:
 
 .. autoclass:: SocketListener

src/trio/_channel.py

@@ -122,16 +122,6 @@ class MemoryChannelStatistics:
 
     Returned by :meth:`MemorySendChannel.statistics` and
     :meth:`MemoryReceiveChannel.statistics`.
-
-    Attributes:
-        current_buffer_used: The number of items currently buffered in the channel.
-        max_buffer_size: The maximum number of items that can be buffered.
-        open_send_channels: The number of open
-            :class:`MemorySendChannel` endpoints.
-        open_receive_channels: The number of open
-            :class:`MemoryReceiveChannel` endpoints.
-        tasks_waiting_send: The number of tasks waiting to send.
-        tasks_waiting_receive: The number of tasks waiting to receive.
     """
 
     current_buffer_used: int
@@ -171,8 +161,7 @@ class MemorySendChannel(SendChannel[SendType], metaclass=NoPublicConstructor):
     """The send end of a memory channel, created by
     :func:`open_memory_channel`.
 
-    See :ref:`channels` for details. This implements the
-    :class:`trio.abc.SendChannel` interface.
+    See :ref:`channels` for details.
 
     """
 
@@ -327,8 +316,7 @@ class MemoryReceiveChannel(ReceiveChannel[ReceiveType], metaclass=NoPublicConstr
     """The receive end of a memory channel, created by
     :func:`open_memory_channel`.
 
-    See :ref:`channels` for details. This implements the
-    :class:`trio.abc.ReceiveChannel` interface.
+    See :ref:`channels` for details.
 
     """
 

src/trio/_core/_parking_lot.py

@@ -152,8 +152,6 @@ class ParkingLot:
     # items
     _parked: OrderedDict[Task, None] = attrs.field(factory=OrderedDict, init=False)
     broken_by: list[Task] = attrs.field(factory=list, init=False)
-    """List of tasks that have broken this parking lot via
-    :meth:`break_lot`. An empty list if the lot has not been broken."""
 
     def __len__(self) -> int:
         """Returns the number of parked tasks."""

src/trio/_highlevel_socket.py

@@ -107,7 +107,6 @@ def __init__(self, socket: SocketType) -> None:
                 self.setsockopt(tsocket.IPPROTO_TCP, tsocket.TCP_NOTSENT_LOWAT, 2**14)
 
     async def send_all(self, data: bytes | bytearray | memoryview) -> None:
-        """See :meth:`trio.abc.SendStream.send_all`."""
         if self.socket.did_shutdown_SHUT_WR:
             raise trio.ClosedResourceError("can't send data after sending EOF")
         with self._send_conflict_detector:
@@ -125,15 +124,13 @@ async def send_all(self, data: bytes | bytearray | memoryview) -> None:
                         total_sent += sent
 
     async def wait_send_all_might_not_block(self) -> None:
-        """See :meth:`trio.abc.SendStream.wait_send_all_might_not_block`."""
         with self._send_conflict_detector:
             if self.socket.fileno() == -1:
                 raise trio.ClosedResourceError
             with _translate_socket_errors_to_stream_errors():
                 await self.socket.wait_writable()
 
     async def send_eof(self) -> None:
-        """See :meth:`trio.abc.HalfCloseableStream.send_eof`."""
         with self._send_conflict_detector:
             await trio.lowlevel.checkpoint()
             # On macOS, calling shutdown a second time raises ENOTCONN, but
@@ -144,7 +141,6 @@ async def send_eof(self) -> None:
                 self.socket.shutdown(tsocket.SHUT_WR)
 
     async def receive_some(self, max_bytes: int | None = None) -> bytes:
-        """See :meth:`trio.abc.ReceiveStream.receive_some`."""
         if max_bytes is None:
             max_bytes = DEFAULT_RECEIVE_SIZE
         if max_bytes < 1:
@@ -153,7 +149,6 @@ async def receive_some(self, max_bytes: int | None = None) -> bytes:
             return await self.socket.recv(max_bytes)
 
     async def aclose(self) -> None:
-        """See :meth:`trio.abc.AsyncResource.aclose`."""
         self.socket.close()
         await trio.lowlevel.checkpoint()