diff --git a/core/modules/contextual/contextual.module b/core/modules/contextual/contextual.module
index cb0cdee..92d0448 100644
--- a/core/modules/contextual/contextual.module
+++ b/core/modules/contextual/contextual.module
@@ -216,10 +216,10 @@ function contextual_preprocess(&$variables, $hook, $info) {
  * contains an identifier ("contextual id"), which allows the JavaScript of the
  * drupal.contextual-links library to dynamically render contextual links.
  *
- * @param $element
+ * @param array $element
  *   A structured array with #id containing a "contextual id".
  *
- * @return
+ * @return html
  *   The passed-in element with a contextual link placeholder in '#markup'.
  *
  * @see _contextual_links_to_id()
@@ -233,7 +233,7 @@ function contextual_pre_render_placeholder($element) {
 /**
  * Pre-render callback: Builds a renderable array for contextual links.
  *
- * @param $element
+ * @param array $element
  *   A renderable array containing a #contextual_links property, which is a
  *   keyed array. Each key is the name of the group of contextual links to
  *   render (based on the 'group' key in the *.contextual_links.yml files for
@@ -241,18 +241,19 @@ function contextual_pre_render_placeholder($element) {
  *   the following keys:
  *   - route_parameters: The route parameters passed to the url generator.
  *   - metadata: Any additional data needed in order to alter the link.
- *   @code
- *     array('#contextual_links' => array(
- *       'block' => array(
- *         'route_parameters' => array('block' => 'system.menu-tools'),
- *       ),
- *       'menu' => array(
- *         'route_parameters' => array('menu' => 'tools'),
- *       ),
- *     ))
- *   @endcode
  *
- * @return
+ * @code
+ *   array('#contextual_links' => array(
+ *     'block' => array(
+ *       'route_parameters' => array('block' => 'system.menu-tools'),
+ *     ),
+ *     'menu' => array(
+ *       'route_parameters' => array('menu' => 'tools'),
+ *     ),
+ *   ))
+ * @endcode
+ *
+ * @return array
  *   A renderable array representing contextual links.
  *
  * @see contextual_element_info()
@@ -261,7 +262,7 @@ function contextual_pre_render_links($element) {
   // Retrieve contextual menu links.
   $items = array();
 
-  /** @var $contextual_links_manager \Drupal\Core\Menu\ContextualLinkManager */
+  /** @var $contextual_links_manager \Drupal\Core\Menu\ContextualLinkManager. */
   $contextual_links_manager = \Drupal::service('plugin.manager.menu.contextual_link');
   foreach ($element['#contextual_links'] as $group => $args) {
     $args += array(