diff --git a/newsfragments/1727.docs.rst b/newsfragments/1727.docs.rst
new file mode 100644
index 00000000..0f9e6222
--- /dev/null
+++ b/newsfragments/1727.docs.rst
@@ -0,0 +1,9 @@
+Docs: add guide "Testing your bot" (pytest examples)
+
+Add a new documentation page that shows how to test bot handlers with pytest
+without sending real requests to the Telegram API. The guide includes:
+- an echo handler example
+- a callback query example
+
+Both examples use dummy objects (Message / CallbackQuery) so developers can
+test logic in isolation.