diff --git a/core/modules/link/link.module b/core/modules/link/link.module
index 82840b31769a..24c62866dac7 100644
--- a/core/modules/link/link.module
+++ b/core/modules/link/link.module
@@ -13,8 +13,21 @@ function link_help($path, $arg) {
case 'admin/help#link':
$output = '';
$output .= '' . t('About') . '
';
- $output .= '' . t('The Link module defines a simple link field type for the Field module. Links are external URLs, can have an optional link text for each link, and they can be formatted when displayed. See the Field module help page for more information about fields.', array('@field-help' => url('admin/help/field'))) . '
';
- return $output;
+ $output .= '' . t('The Link module allows you to create fields that contain external URLs and optional link text. See the Field module help and the Field UI help pages for general information on fields and how to create and manage them. For more information, see the online documentation for the Link module.', array('!field' => \Drupal::url('help.page', array('name' => 'field')), '!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')), '!link_documentation' => 'https://drupal.org/documentation/modules/link')) . '
';
+ $output .= '' . t('Uses') . '
';
+ $output .= '';
+ $output .= '- ' . t('Managing and displaying link fields') . '
';
+ $output .= '- ' . t('The settings and the display of the link field can be configured separately. See the Field UI help for more information on how to manage fields and their display.', array('!field_ui' => \Drupal::url('help.page', array('name' => 'field_ui')))) . '
';
+ $output .= '- ' . t('Adding link text') . '
';
+ $output .= '- ' . t('In the field settings you can define additional link text to be optional or required in any link field.') . '
';
+ $output .= '- ' . t('Displaying link text') . '
';
+ $output .= '- ' . t('If link text has been submitted for a URL, then by default this link text is displayed as a link to the URL. If you want to display both the link text and the URL, choose the appropriate link format from the drop-down menu in the Manage display page. If you only want to display the URL even if link text has been submitted, choose Link as the format, and then change its Format settings to display URL only.') . '
';
+ $output .= '- ' . t('Adding attributes to links') . '
';
+ $output .= '- ' . t('You can add attributes to links, by changing the Format settings in the Manage display page. Adding rel="nofollow" notifies search engines that links should not be followed.') . '
';
+ $output .= '- ' . t('Validating URLs') . '
';
+ $output .= '- ' . t('All links are validated after a link field is filled in. They can include anchors or query strings. Links need to start with either the scheme name http or https; other scheme names (for example ftp or git) are not supported.') . '
';
+ $output .= '
';
+ return $output;
}
}