Issue #2897130 by timmillwood, amateescu, Sam152, xjm: Mark workflows module as stable

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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 {
 

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

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;
   }
 }