Issue #2876419 by Sam152, timmillwood, plach: Review content_moderation module...

Issue #2876419 by Sam152, timmillwood, plach: Review content_moderation module and mark code with @internal where necessary

core/modules/content_moderation/src/ContentModerationStateInterface.php

@@ -10,6 +10,8 @@
  *
  * Content moderation state entities track the moderation state of other content
  * entities.
+ *
+ * @internal
  */
 interface ContentModerationStateInterface extends ContentEntityInterface, EntityOwnerInterface {
 

core/modules/content_moderation/src/ContentPreprocess.php

@@ -9,6 +9,8 @@
 
 /**
  * Determines whether a route is the "Latest version" tab of a node.
+ *
+ * @internal
  */
 class ContentPreprocess implements ContainerInjectionInterface {
 

core/modules/content_moderation/src/Entity/ContentModerationState.php

@@ -39,6 +39,11 @@
  *     "langcode" = "langcode",
  *   }
  * )
+ *
+ * @internal
+ *   This entity is marked internal because it should not be used directly to
+ *   alter the moderation state of an entity. Instead, the computed
+ *   moderation_state field should be set on the entity directly.
  */
 class ContentModerationState extends ContentEntityBase implements ContentModerationStateInterface {
 

core/modules/content_moderation/src/EntityOperations.php

@@ -14,6 +14,8 @@
 
 /**
  * Defines a class for reacting to entity events.
+ *
+ * @internal
  */
 class EntityOperations implements ContainerInjectionInterface {
 

core/modules/content_moderation/src/EntityTypeInfo.php

@@ -26,6 +26,8 @@
  *
  * This class contains primarily bridged hooks for compile-time or
  * cache-clear-time hooks. Runtime hooks should be placed in EntityOperations.
+ *
+ * @internal
  */
 class EntityTypeInfo implements ContainerInjectionInterface {
 

core/modules/content_moderation/src/Permissions.php

@@ -7,6 +7,8 @@
 
 /**
  * Defines a class for dynamic permissions based on transitions.
+ *
+ * @internal
  */
 class Permissions {
 

core/modules/content_moderation/src/RevisionTracker.php

@@ -8,6 +8,8 @@
 
 /**
  * Tracks metadata about revisions across entities.
+ *
+ * @internal
  */
 class RevisionTracker implements RevisionTrackerInterface {
 

core/modules/content_moderation/src/RevisionTrackerInterface.php

@@ -4,6 +4,8 @@
 
 /**
  * Tracks metadata about revisions across content entities.
+ *
+ * @internal
  */
 interface RevisionTrackerInterface {
 

core/modules/content_moderation/src/Routing/EntityModerationRouteProvider.php

@@ -17,6 +17,8 @@
  * Provides the following routes:
  * - The latest version tab, showing the latest revision of an entity, not the
  *   default one.
+ *
+ * @internal
  */
 class EntityModerationRouteProvider implements EntityRouteProviderInterface, EntityHandlerInterface {
 

core/modules/content_moderation/src/ViewsData.php

@@ -8,6 +8,8 @@
 
 /**
  * Provides the content_moderation views integration.
+ *
+ * @internal
  */
 class ViewsData {