diff --git a/changelogs/client_server/newsfragments/1284.clarification b/changelogs/client_server/newsfragments/1284.clarification
new file mode 100644
index 00000000..bd52dbd4
--- /dev/null
+++ b/changelogs/client_server/newsfragments/1284.clarification
@@ -0,0 +1 @@
+Improve documentation about ephemeral events.
\ No newline at end of file