diff --git a/core/modules/workflows/src/WorkflowTypeInterface.php b/core/modules/workflows/src/WorkflowTypeInterface.php
index 00c10ec9..7509e7cb 100644
--- a/core/modules/workflows/src/WorkflowTypeInterface.php
+++ b/core/modules/workflows/src/WorkflowTypeInterface.php
@@ -248,15 +248,15 @@ public function getTransitions(array $transition_ids = NULL);
    * @param $state_id
    *   The state to get transitions for.
    * @param string $direction
-   *   (optional) The direction of the transition.
-   *   Defaults to TransitionInterface::DIRECTION_FROM.
-   *   Possible values are:
+   *   (optional) The direction of the transition, defaults to
+   *   TransitionInterface::DIRECTION_FROM. Possible values are:
    *   TransitionInterface::DIRECTION_FROM or TransitionInterface::DIRECTION_TO.
    *
    * @return array
    *   The transition IDs for a state for the provided direction.
    *
-   * @see \Drupal\workflows\TransitionInterface
+   * @see \Drupal\workflows\TransitionInterface::DIRECTION_FROM
+   * @see \Drupal\workflows\TransitionInterface::DIRECTION_TO
    */
   public function getTransitionsForState($state_id, $direction = TransitionInterface::DIRECTION_FROM);