Issue #2772251 by msankhala, markpavlitski, joachim: description for...

Issue #2772251 by msankhala, markpavlitski, joachim: description for EntityForm::actions() could use rewording

core/lib/Drupal/Core/Entity/EntityForm.php

@@ -221,6 +221,17 @@ protected function actionsElement(array $form, FormStateInterface $form_state) {
   /**
    * Returns an array of supported actions for the current entity form.
    *
+   * This function generates a list of Form API elements which represent
+   * actions supported by the current entity form.
+   *
+   * @param array $form
+   *   An associative array containing the structure of the form.
+   * @param \Drupal\Core\Form\FormStateInterface $form_state
+   *   The current state of the form.
+   *
+   * @return array
+   *   An array of supported Form API action elements keyed by name.
+   *
    * @todo Consider introducing a 'preview' action here, since it is used by
    *   many entity types.
    */