diff --git a/lib/public/notification/iaction.php b/lib/public/notification/iaction.php
index f0dfb02496..334f6cc44a 100644
--- a/lib/public/notification/iaction.php
+++ b/lib/public/notification/iaction.php
@@ -26,6 +26,10 @@ namespace OCP\Notification;
  *
  * @package OCP\Notification
  * @since 8.2.0
+ *
+ * DEVELOPER NOTE:
+ * The notification api is experimental only in 8.2.0! Do not start using it,
+ * if you can not prepare an update for the next version afterwards.
  */
 interface IAction {
 	/**
diff --git a/lib/public/notification/iapp.php b/lib/public/notification/iapp.php
index b154efab75..b7bf41ce7f 100644
--- a/lib/public/notification/iapp.php
+++ b/lib/public/notification/iapp.php
@@ -26,6 +26,10 @@ namespace OCP\Notification;
  *
  * @package OCP\Notification
  * @since 8.2.0
+ *
+ * DEVELOPER NOTE:
+ * The notification api is experimental only in 8.2.0! Do not start using it,
+ * if you can not prepare an update for the next version afterwards.
  */
 interface IApp {
 	/**
diff --git a/lib/public/notification/imanager.php b/lib/public/notification/imanager.php
index e68f19e71f..ca1cc968b1 100644
--- a/lib/public/notification/imanager.php
+++ b/lib/public/notification/imanager.php
@@ -26,6 +26,10 @@ namespace OCP\Notification;
  *
  * @package OCP\Notification
  * @since 8.2.0
+ *
+ * DEVELOPER NOTE:
+ * The notification api is experimental only in 8.2.0! Do not start using it,
+ * if you can not prepare an update for the next version afterwards.
  */
 interface IManager extends IApp, INotifier {
 	/**
diff --git a/lib/public/notification/inotification.php b/lib/public/notification/inotification.php
index 48204f733c..51d4a80464 100644
--- a/lib/public/notification/inotification.php
+++ b/lib/public/notification/inotification.php
@@ -26,6 +26,10 @@ namespace OCP\Notification;
  *
  * @package OCP\Notification
  * @since 8.2.0
+ *
+ * DEVELOPER NOTE:
+ * The notification api is experimental only in 8.2.0! Do not start using it,
+ * if you can not prepare an update for the next version afterwards.
  */
 interface INotification {
 	/**
diff --git a/lib/public/notification/inotifier.php b/lib/public/notification/inotifier.php
index 32628768eb..be6b3f2553 100644
--- a/lib/public/notification/inotifier.php
+++ b/lib/public/notification/inotifier.php
@@ -26,6 +26,10 @@ namespace OCP\Notification;
  *
  * @package OCP\Notification
  * @since 8.2.0
+ *
+ * DEVELOPER NOTE:
+ * The notification api is experimental only in 8.2.0! Do not start using it,
+ * if you can not prepare an update for the next version afterwards.
  */
 interface INotifier {
 	/**