From df6bc0c9706688f2a87ade43426e779157f3ac1e Mon Sep 17 00:00:00 2001
From: jaimergp <jaimergp@users.noreply.github.com>
Date: Fri, 21 Nov 2025 17:12:42 +0100
Subject: [PATCH] How to: Talk to the bots

---
 docs/_sidebar_diataxis.json              |  4 ++--
 docs/how-to/advanced/talk-to-the-bots.md | 16 ++++++++++++++++
 2 files changed, 18 insertions(+), 2 deletions(-)
 create mode 100644 docs/how-to/advanced/talk-to-the-bots.md

diff --git a/docs/_sidebar_diataxis.json b/docs/_sidebar_diataxis.json
index 85e4319dcd..f12a72b52e 100644
--- a/docs/_sidebar_diataxis.json
+++ b/docs/_sidebar_diataxis.json
@@ -90,9 +90,9 @@
             "href": "/docs/maintainer/knowledge_base/#apple-silicon-builds"
           },
           {
-            "type": "link",
+            "type": "doc",
             "label": "Talk to the bots",
-            "href": "/docs/maintainer/conda_forge_yml/"
+            "id": "how-to/advanced/talk-to-the-bots"
           },
           {
             "type": "link",
diff --git a/docs/how-to/advanced/talk-to-the-bots.md b/docs/how-to/advanced/talk-to-the-bots.md
new file mode 100644
index 0000000000..bcf4f23597
--- /dev/null
+++ b/docs/how-to/advanced/talk-to-the-bots.md
@@ -0,0 +1,16 @@
+---
+tags: [how-to, advanced]
+---
+
+# How to talk to the bots
+
+Some parts of the conda-forge automation are exposed as "bot commands" that can be invoked from issue titles and comments. You can check the full list in the [admin-web-services](/docs/maintainer/infrastructure.md#admin-web-services) documentation.
+
+Bot commands typically start with `@conda-forge-admin, please`. Bot commands can have two types of scope:
+
+- Repository scope: The command is typed as the title of a new issue in the target feedstock, or in an issue comment.
+- Pull request scope: The command is typed as a pull request comment or review.
+
+Some commands may have dual behavior. For example `@conda-forge-admin, please rerender` can be used as an issue title to create a new PR after rerendering from `main`, but it can also be used within a PR to rerender the head branch and push a new commit automatically.
+
+The bots will usually react to the comment with a 🚀 emoji, and later post a comment informing about progress and outcome.