diff --git a/docs/modules/configuration/pages/announce/discussions.adoc b/docs/modules/configuration/pages/announce/discussions.adoc
index b7ba1ca..ac611be 100644
--- a/docs/modules/configuration/pages/announce/discussions.adoc
+++ b/docs/modules/configuration/pages/announce/discussions.adoc
@@ -3,6 +3,8 @@
 Posts a message to link:https://docs.github.com/en/discussions[GitHub Discussions]. You must provide a GitHub token with
 the `write:discussion` scope enabled. Will use the same token set in xref:configuration:release/github.adoc[].
 
+NOTE: GitHub discussions are currently only possible for repositories that belong to organizations.
+
 include::partial$legend.adoc[]
 
 [tabs]