diff --git a/changelog/12153.doc.rst b/changelog/12153.doc.rst
new file mode 100644
index 000000000..aa62cca49
--- /dev/null
+++ b/changelog/12153.doc.rst
@@ -0,0 +1 @@
+Updated docs: Documented a better way to detect if a code is running from within a pytest run.