Add @param and @return to docbloc

[lostcarpark]

At present, the docbloc Smart Snippits generates is fairly minimal, e.g.:

/**
 * Implements hook_form_alter().
 */

It would be great if a more complete docbloc could be generated. For example:

/**
 * Implements hook_form_alter().
 * 
 * @param array &$form
 *   The form array.
 * @param \Drupal\Core\Form\FormStateInterface $form_state
 *   The current state of the form.
 * @param string $form_id
 *   The form identification.
 */

[andy-blum]

This is currently not in line with the Drupal coding standards, though there is an open issue to change this

[lostcarpark]

Thanks for the clarification.