From c98feb8ff1d81219a4df6bd121a000aee3f96e88 Mon Sep 17 00:00:00 2001
From: bpiper02 <pbrent135@gmail.com>
Date: Wed, 9 Sep 2026 20:10:26 -0400
Subject: [PATCH] Document ParkingLot.broken_by

---
 docs/source/conf.py            | 1 -
 src/trio/_core/_parking_lot.py | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index eb278bf65f..c9484de418 100755
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -174,7 +174,6 @@ def autodoc_process_signature(
 logger = getLogger("trio")
 UNDOCUMENTED = {
     "trio._subprocess.HasFileno.fileno",
-    "trio.lowlevel.ParkingLot.broken_by",
 }
 
 
diff --git a/src/trio/_core/_parking_lot.py b/src/trio/_core/_parking_lot.py
index ddf6276117..853ef024cf 100644
--- a/src/trio/_core/_parking_lot.py
+++ b/src/trio/_core/_parking_lot.py
@@ -152,6 +152,7 @@ class ParkingLot:
     # items
     _parked: OrderedDict[Task, None] = attrs.field(factory=OrderedDict, init=False)
     broken_by: list[Task] = attrs.field(factory=list, init=False)
+    """The tasks that have broken this parking lot."""
 
     def __len__(self) -> int:
         """Returns the number of parked tasks."""