Merge pull request #1898 from davep/extend-api-docs-linkage

Increase the coverage of API documentation

docs/api/await_remove.md

@@ -0,0 +1 @@
+::: textual.await_remove

docs/api/binding.md

@@ -1 +1 @@
-::: textual.binding.Binding
+::: textual.binding

docs/api/coordinate.md

@@ -1 +1 @@
-::: textual.coordinate.Coordinate
+::: textual.coordinate

docs/api/dom_node.md

@@ -1 +1 @@
-::: textual.dom.DOMNode
+::: textual.dom

docs/api/message.md

@@ -1 +1 @@
-::: textual.message.Message
+::: textual.message

docs/api/message_pump.md

@@ -2,4 +2,4 @@ A message pump is a class that processes messages.
 
 It is a base class for the `App`, `Screen`, and `Widget` classes.
 
-::: textual.message_pump.MessagePump
+::: textual.message_pump

docs/api/scroll_view.md

@@ -1 +1 @@
-::: textual.scroll_view.ScrollView
+::: textual.scroll_view

docs/api/strip.md

@@ -1 +1 @@
-::: textual.strip.Strip
+::: textual.strip

docs/api/widget.md

@@ -1 +1 @@
-::: textual.widget.Widget
+::: textual.widget

mkdocs-nav.yml

@@ -142,6 +142,7 @@ nav:
       - "widgets/tree.md"
   - API:
     - "api/app.md"
+    - "api/await_remove.md"
     - "api/binding.md"
     - "api/button.md"
     - "api/checkbox.md"

src/textual/await_remove.py

@@ -5,7 +5,11 @@ from typing import Generator
 
 
 class AwaitRemove:
-    """An awaitable returned by App.remove and DOMQuery.remove."""
+    """An awaitable returned by a method that removes DOM nodes.
+
+    Returned by [Widget.remove][textual.widget.Widget.remove] and
+    [DOMQuery.remove][textual.css.query.DOMQuery.remove].
+    """
 
     def __init__(self, finished_flag: Event, task: Task) -> None:
         """Initialise the instance of ``AwaitRemove``.