From 10c3eba2b759e6807513873cf60f434dc0224697 Mon Sep 17 00:00:00 2001
From: Benjamin Marten <74664424+porti20@users.noreply.github.com>
Date: Wed, 7 Dec 2022 10:27:03 +0100
Subject: [PATCH] doc: Clarify prioritisation of used slot asking option in
 forms (#11801)

* add testing story example for button with payload

* Create 11766.doc.md

* Fix spelling in changelog/11766.doc.md

Co-authored-by: Anca Lita <27920906+ancalita@users.noreply.github.com>

* fix button example highlight line in docs/docs/testing-your-assistant.mdx

Co-authored-by: Anca Lita <27920906+ancalita@users.noreply.github.com>

* Update forms.mdx

Clarify prioritisation of used slot asking option in forms.

* Create 11801.doc.md

Co-authored-by: Anca Lita <27920906+ancalita@users.noreply.github.com>
---
 changelog/11801.doc.md | 1 +
 docs/docs/forms.mdx    | 8 ++++++++
 2 files changed, 9 insertions(+)
 create mode 100644 changelog/11801.doc.md

diff --git a/changelog/11801.doc.md b/changelog/11801.doc.md
new file mode 100644
index 000000000000..0b6a7bbf6d0e
--- /dev/null
+++ b/changelog/11801.doc.md
@@ -0,0 +1 @@
+Clarify prioritisation of used slot asking option in forms in documentation.
diff --git a/docs/docs/forms.mdx b/docs/docs/forms.mdx
index c82506e792b7..ded6db5cf0c9 100644
--- a/docs/docs/forms.mdx
+++ b/docs/docs/forms.mdx
@@ -491,3 +491,11 @@ class AskForSlotAction(Action):
         dispatcher.utter_message(text="What cuisine?")
         return []
 ```
+
+If there is more than one asking option for the slot, Rasa prioritizes in the following order:
+
+1. `action_ask_<form_name>_<slot_name>`
+2. `utter_ask_<form_name>_<slot_name>`
+3. `action_ask_<slot_name>`
+4. `utter_ask_<slot_name>`
+