diff --git a/core/modules/workflows/src/StateInterface.php b/core/modules/workflows/src/StateInterface.php
index 771658cd2552ea128b6512725d66a30a389394ea..3335ea7452a597f239071616783101b21532baf4 100644
--- a/core/modules/workflows/src/StateInterface.php
+++ b/core/modules/workflows/src/StateInterface.php
@@ -4,6 +4,10 @@
 
 /**
  * An interface for state value objects.
+ *
+ * @internal
+ *   The StateInterface should only be used by Workflows and Content Moderation.
+ * @todo Revisit the need for this in https://www.drupal.org/node/2902309.
  */
 interface StateInterface {
 
diff --git a/core/modules/workflows/src/TransitionInterface.php b/core/modules/workflows/src/TransitionInterface.php
index 7db34e8dd90cc0ff16fe96ad91b64e3a35719c0b..ae3f0231be4a52c97e59f1d9ff28ff0014c041b4 100644
--- a/core/modules/workflows/src/TransitionInterface.php
+++ b/core/modules/workflows/src/TransitionInterface.php
@@ -4,6 +4,12 @@
 
 /**
  * A transition value object that describes the transition between two states.
+ *
+ * @internal
+ *   The TransitionInterface should only be used by Workflows and Content
+ *   Moderation.
+ *
+ * @todo Revisit the need for this in https://www.drupal.org/node/2902309.
  */
 interface TransitionInterface {