docs(README) Overhaul README

CHANGES

@@ -714,6 +714,18 @@ be a few months in waiting (watchers / snapshots are in development in #587).
 
 - Typo fix for `Pane.send_keys` (#593), thank you @subbyte!
 
+### New features
+
+#### Waiting (#582)
+
+Added experimental `waiter.py` module for polling for terminal content in tmux panes:
+
+- Fluent API inspired by Playwright for better readability and chainable options
+- Support for multiple pattern types (exact text, contains, regex, custom predicates)
+- Composable waiting conditions with `wait_for_any_content` and `wait_for_all_content`
+- Enhanced error handling with detailed timeouts and match information
+- Robust shell prompt detection
+
 ## libtmux 0.46.0 (2025-02-25)
 
 ### Breaking