From 34697034b7aa6041b8a94f001875313504b32591 Mon Sep 17 00:00:00 2001
From: xjm <xjm@65776.no-reply.drupal.org>
Date: Wed, 6 Sep 2017 11:02:08 -0500
Subject: [PATCH] Issue #2897130 by timmillwood, amateescu, Sam152, xjm: Mark
 workflows module as stable

---
 core/modules/workflows/src/Annotation/WorkflowType.php      | 4 ----
 core/modules/workflows/src/Entity/Workflow.php              | 4 ----
 core/modules/workflows/src/Plugin/WorkflowTypeBase.php      | 4 ----
 core/modules/workflows/src/State.php                        | 4 ----
 core/modules/workflows/src/StateInterface.php               | 4 ----
 core/modules/workflows/src/Transition.php                   | 4 ----
 core/modules/workflows/src/TransitionInterface.php          | 5 -----
 core/modules/workflows/src/WorkflowAccessControlHandler.php | 4 ----
 core/modules/workflows/src/WorkflowInterface.php            | 4 ----
 core/modules/workflows/src/WorkflowTypeInterface.php        | 4 ----
 core/modules/workflows/src/WorkflowTypeManager.php          | 4 ----
 core/modules/workflows/workflows.info.yml                   | 2 +-
 core/modules/workflows/workflows.module                     | 6 ++++++
 13 files changed, 7 insertions(+), 46 deletions(-)

diff --git a/core/modules/workflows/src/Annotation/WorkflowType.php b/core/modules/workflows/src/Annotation/WorkflowType.php
index 8ba6aec8407e..496a9b822412 100644
--- a/core/modules/workflows/src/Annotation/WorkflowType.php
+++ b/core/modules/workflows/src/Annotation/WorkflowType.php
@@ -17,10 +17,6 @@ use Drupal\Component\Annotation\Plugin;
  * @see plugin_api
  *
  * @Annotation
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class WorkflowType extends Plugin {
 
diff --git a/core/modules/workflows/src/Entity/Workflow.php b/core/modules/workflows/src/Entity/Workflow.php
index b9031614da16..2450fb78473d 100644
--- a/core/modules/workflows/src/Entity/Workflow.php
+++ b/core/modules/workflows/src/Entity/Workflow.php
@@ -56,10 +56,6 @@ use Drupal\workflows\WorkflowInterface;
  *     "type_settings",
  *   },
  * )
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class Workflow extends ConfigEntityBase implements WorkflowInterface, EntityWithPluginCollectionInterface {
 
diff --git a/core/modules/workflows/src/Plugin/WorkflowTypeBase.php b/core/modules/workflows/src/Plugin/WorkflowTypeBase.php
index 6f4e9ceeedfb..5810938d7062 100644
--- a/core/modules/workflows/src/Plugin/WorkflowTypeBase.php
+++ b/core/modules/workflows/src/Plugin/WorkflowTypeBase.php
@@ -14,10 +14,6 @@ use Drupal\workflows\WorkflowTypeInterface;
  * A base class for Workflow type plugins.
  *
  * @see \Drupal\workflows\Annotation\WorkflowType
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 abstract class WorkflowTypeBase extends PluginBase implements WorkflowTypeInterface {
 
diff --git a/core/modules/workflows/src/State.php b/core/modules/workflows/src/State.php
index c40c2a7dfc56..5149e265e97b 100644
--- a/core/modules/workflows/src/State.php
+++ b/core/modules/workflows/src/State.php
@@ -4,10 +4,6 @@ namespace Drupal\workflows;
 
 /**
  * A value object representing a workflow state.
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class State implements StateInterface {
 
diff --git a/core/modules/workflows/src/StateInterface.php b/core/modules/workflows/src/StateInterface.php
index 6cc8ace95c97..771658cd2552 100644
--- a/core/modules/workflows/src/StateInterface.php
+++ b/core/modules/workflows/src/StateInterface.php
@@ -4,10 +4,6 @@ namespace Drupal\workflows;
 
 /**
  * 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/Transition.php b/core/modules/workflows/src/Transition.php
index 38d5dbac0379..233f28bdf5dd 100644
--- a/core/modules/workflows/src/Transition.php
+++ b/core/modules/workflows/src/Transition.php
@@ -4,10 +4,6 @@ namespace Drupal\workflows;
 
 /**
  * A transition value object that describes the transition between states.
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class Transition implements TransitionInterface {
 
diff --git a/core/modules/workflows/src/TransitionInterface.php b/core/modules/workflows/src/TransitionInterface.php
index 0fa159cabfb7..7db34e8dd90c 100644
--- a/core/modules/workflows/src/TransitionInterface.php
+++ b/core/modules/workflows/src/TransitionInterface.php
@@ -4,11 +4,6 @@ namespace Drupal\workflows;
 
 /**
  * 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 {
 
diff --git a/core/modules/workflows/src/WorkflowAccessControlHandler.php b/core/modules/workflows/src/WorkflowAccessControlHandler.php
index e34e647e0858..1e0456cf6dfa 100644
--- a/core/modules/workflows/src/WorkflowAccessControlHandler.php
+++ b/core/modules/workflows/src/WorkflowAccessControlHandler.php
@@ -15,10 +15,6 @@ use Symfony\Component\DependencyInjection\ContainerInterface;
  * Access controller for the Workflow entity.
  *
  * @see \Drupal\workflows\Entity\Workflow.
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class WorkflowAccessControlHandler extends EntityAccessControlHandler implements EntityHandlerInterface {
 
diff --git a/core/modules/workflows/src/WorkflowInterface.php b/core/modules/workflows/src/WorkflowInterface.php
index 41741628af4f..dc09956ec3b8 100644
--- a/core/modules/workflows/src/WorkflowInterface.php
+++ b/core/modules/workflows/src/WorkflowInterface.php
@@ -6,10 +6,6 @@ use Drupal\Core\Config\Entity\ConfigEntityInterface;
 
 /**
  * Provides an interface for defining workflow entities.
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 interface WorkflowInterface extends ConfigEntityInterface {
 
diff --git a/core/modules/workflows/src/WorkflowTypeInterface.php b/core/modules/workflows/src/WorkflowTypeInterface.php
index 4ffa4d07a1c4..5ef843b4cb3e 100644
--- a/core/modules/workflows/src/WorkflowTypeInterface.php
+++ b/core/modules/workflows/src/WorkflowTypeInterface.php
@@ -8,10 +8,6 @@ use Drupal\Core\Plugin\PluginWithFormsInterface;
 
 /**
  * An interface for Workflow type plugins.
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 interface WorkflowTypeInterface extends PluginWithFormsInterface, DerivativeInspectionInterface, ConfigurablePluginInterface {
 
diff --git a/core/modules/workflows/src/WorkflowTypeManager.php b/core/modules/workflows/src/WorkflowTypeManager.php
index b1675380bf44..60dfa7b7be64 100644
--- a/core/modules/workflows/src/WorkflowTypeManager.php
+++ b/core/modules/workflows/src/WorkflowTypeManager.php
@@ -13,10 +13,6 @@ use Drupal\workflows\Annotation\WorkflowType;
  * @see \Drupal\workflows\Annotation\WorkflowType
  * @see \Drupal\workflows\WorkflowTypeInterface
  * @see plugin_api
- *
- * @internal
- *   The workflow system is currently experimental and should only be leveraged
- *   by experimental modules and development releases of contributed modules.
  */
 class WorkflowTypeManager extends DefaultPluginManager {
 
diff --git a/core/modules/workflows/workflows.info.yml b/core/modules/workflows/workflows.info.yml
index 4f307d1513de..c40a7aae5470 100644
--- a/core/modules/workflows/workflows.info.yml
+++ b/core/modules/workflows/workflows.info.yml
@@ -3,5 +3,5 @@ type: module
 description: 'Provides UI and API for managing workflows. This module can be used with the Content moderation module to add highly customizable workflows to content.'
 version: VERSION
 core: 8.x
-package: Core (Experimental)
+package: Core
 configure: entity.workflow.collection
diff --git a/core/modules/workflows/workflows.module b/core/modules/workflows/workflows.module
index f72d7bd32c9a..a22cadff97d2 100644
--- a/core/modules/workflows/workflows.module
+++ b/core/modules/workflows/workflows.module
@@ -16,6 +16,12 @@ function workflows_help($route_name, RouteMatchInterface $route_match) {
       $output = '';
       $output .= '<h3>' . t('About') . '</h3>';
       $output .= '<p>' . t('The Workflows module provides a UI and an API for creating workflows content. This lets site admins define workflows and their states, and then define transitions between those states. For more information, see the <a href=":workflow">online documentation for the Workflows module</a>.', [':workflow' => 'https://www.drupal.org/documentation/modules/workflows']) . '</p>';
+      $output .= '<h4>' . t('Workflow') . '</h4>';
+      $output .= '<p>' . t('A collection of states and transitions between those states.') . '</p>';
+      $output .= '<h4>' . t('State') . '</h4>';
+      $output .= '<p>' . t('A particular condition that something is in at a specific time. The usage of the state is determined by a module that harnesses the Workflows module. For example, Content Moderation allows a state to be used for moderation of content by assigning a given state to a content item.') . '</p>';
+      $output .= '<h4>' . t('Transition') . '</h4>';
+      $output .= '<p>' . t('The process of changing from one state to another. A transition can occur from multiple states, but only to one state.') . '</p>';
       return $output;
   }
 }