diff --git a/src/textual/_compositor.py b/src/textual/_compositor.py
index e9965db8b..245eb3f34 100644
--- a/src/textual/_compositor.py
+++ b/src/textual/_compositor.py
@@ -308,6 +308,9 @@ class Compositor:
             parent: The root widget.
             size: Size of the area to be filled.
 
+        Returns:
+            Set of widgets that were exposed by the scroll.
+
         """
         self._cuts = None
         self._layers = None
diff --git a/src/textual/_layout.py b/src/textual/_layout.py
index f65541bae..f7ab16312 100644
--- a/src/textual/_layout.py
+++ b/src/textual/_layout.py
@@ -18,8 +18,11 @@ ArrangeResult: TypeAlias = "tuple[list[WidgetPlacement], set[Widget]]"
 @dataclass
 class DockArrangeResult:
     placements: list[WidgetPlacement]
+    """A `WidgetPlacement` for every widget to describe it's location on screen."""
     widgets: set[Widget]
+    """A set of widgets in the arrangement."""
     spacing: Spacing
+    """Shared spacing around the widgets."""
 
     _spatial_map: SpatialMap[WidgetPlacement] | None = None