From af88d9b0e34a1b635ccf96ffd5257288a2042425 Mon Sep 17 00:00:00 2001
From: Jaskowicz1 <archiejaskowicz@gmail.com>
Date: Fri, 23 Feb 2024 16:18:38 +0000
Subject: [PATCH] docs: added a thinking page

---
 docpages/example_code/thinking.cpp         | 36 ++++++++++++++++++++++
 docpages/example_programs/misc/thinking.md |  9 ++++++
 2 files changed, 45 insertions(+)
 create mode 100644 docpages/example_code/thinking.cpp
 create mode 100644 docpages/example_programs/misc/thinking.md

diff --git a/docpages/example_code/thinking.cpp b/docpages/example_code/thinking.cpp
new file mode 100644
index 0000000000..dce146e619
--- /dev/null
+++ b/docpages/example_code/thinking.cpp
@@ -0,0 +1,36 @@
+#include <dpp/dpp.h>
+
+int main() {
+	dpp::cluster bot("token");
+
+	bot.on_log(dpp::utility::cout_logger());
+
+	/* The event is fired when someone issues your commands */
+	bot.on_slashcommand([&bot](const dpp::slashcommand_t& event) {
+		/* Check which command they ran */
+		if (event.command.get_command_name() == "thinking") {
+			/*
+			 * true for Ephemeral. 
+			 * You can set this to false if you want everyone to see the thinking response.
+			 */
+			event.thinking(true, [event](const dpp::confirmation_callback_t& callback) {
+				event.edit_original_response(dpp::message("thonk"));
+			});
+
+		}
+	});
+
+	bot.on_ready([&bot](const dpp::ready_t& event) {
+		if (dpp::run_once<struct register_bot_commands>()) {
+			/* Create a new global command on ready event */
+			dpp::slashcommand newcommand("thinking", "Thinking example...", bot.me.id);
+
+			/* Register the command */
+			bot.global_command_create(newcommand);
+		}
+	});
+
+	bot.start(dpp::st_wait);
+
+	return 0;
+}
diff --git a/docpages/example_programs/misc/thinking.md b/docpages/example_programs/misc/thinking.md
new file mode 100644
index 0000000000..87bb2a09aa
--- /dev/null
+++ b/docpages/example_programs/misc/thinking.md
@@ -0,0 +1,9 @@
+\page thinking Thinking
+
+A common mistake people do is use `event.thinking` with `event.reply`, however, they always run into the `Interaction has already been acknowledged.` error! The reason for this is because `event.thinking` is a response to the interaction, meaning you have acknowledged it! You should use dpp::interaction_create_t::edit_original_response instead.
+
+Below is an example, showing how you should properly use the thinking method.
+
+\include{cpp} thinking.cpp
+
+This will make the bot think briefly, then change the response to "thonk"!