diff --git a/core/modules/media/media.module b/core/modules/media/media.module
index 5df059c..dc4bcbb 100644
--- a/core/modules/media/media.module
+++ b/core/modules/media/media.module
@@ -20,18 +20,30 @@ function media_help($route_name, RouteMatchInterface $route_match) {
switch ($route_name) {
case 'help.page.media':
$output = '' . t('About') . '
';
- $output .= '' . t('The Media module manages the creation, editing, deletion, settings and display of media. Items are typically images, documents, slideshows, YouTube videos, tweets, Instagram photos, etc. You can reference media items from any other content on your site. For more information, see the online documentation for the Media module.', [':media' => 'https://www.drupal.org/docs/8/core/modules/media']) . '
';
+ $output .= '' . t('The Media module manages the creation, editing, deletion, settings, and display of media. Items are typically images, documents, slideshows, YouTube videos, tweets, Instagram photos, etc. You can reference media items from any other content on your site. For more information, see the online documentation for the Media module.', [':media' => 'https://www.drupal.org/docs/8/core/modules/media']) . '
';
$output .= '' . t('Uses') . '
';
$output .= '';
$output .= '- ' . t('Creating media items') . '
';
$output .= '- ' . t('When a new media item is created, the Media module records basic information about it, including the author, date of creation, and the media type. It also manages the publishing options, which define whether or not the item is published. Default settings can be configured for each type of media on your site.', [':media-type' => Url::fromRoute('entity.media_type.collection')->toString()]) . '
';
+ $output .= '- ' . t('Listing media items') . '
';
+ $output .= '- ' . t('Media items are listed at Content > Media.') . '
';
$output .= '- ' . t('Creating custom media types') . '
';
$output .= '- ' . t('The Media module gives users with the Administer media types permission the ability to create new media types in addition to the default ones already configured. Each media type has an associated media source (such as the image source) which support thumbnail generation and metadata extraction. Fields managed by the Field module may be added for storing that metadata, such as width and height, as well as any other associated values.', [':media-new' => Url::fromRoute('entity.media_type.add_form')->toString(), ':field' => Url::fromRoute('help.page', ['name' => 'field'])->toString()]) . '
';
$output .= '- ' . t('Creating revisions') . '
';
$output .= '- ' . t('The Media module also enables you to create multiple versions of any media item, and revert to older versions using the Revision information settings.') . '
';
$output .= '- ' . t('User permissions') . '
';
$output .= '- ' . t('The Media module makes a number of permissions available, which can be set by role on the permissions page.', [':permissions' => Url::fromRoute('user.admin_permissions', [], ['fragment' => 'module-media'])->toString()]) . '
';
+ $output .= '- ' . t('Adding media to other content') . '
';
+ $output .= '- ' . t('Users with permission to administer content types can add media support by adding a media reference field to the content type on the content type administration page. (The same is true of block types, taxonomy terms, user profiles, and other content that supports fields.) A media reference field can refer to any configured media type. It is possible to allow multiple media types in the same field.') . '
';
$output .= '
';
+ $output .= '' . t('Differences between Media, File, and Image reference fields') . '
';
+ $output .= '' . t('There are several differences between the Media, File, and Image reference fields. When in doubt, it is recommended to use a media reference.') . '
';
+ $output .= '';
+ $output .= '- ' . t('The media reference fields can contain references to multiple media types in the same field. This makes it possible to reference an image and video in the same field. The file and image reference fields only allow a single type per field.') . '
';
+ $output .= '- ' . t('Besides local file uploads, the media reference fields allow remote media types to be configured. This can be used to reference a Youtube video for example. The file and image reference field can only contain local file uploads.') . '
';
+ $output .= '- ' . t('Since media types are fieldable, the media reference fields can allow additional metadata to be added. File and image reference fields have a fixed set of allowed metadata. The file and image media types are configured to use file and image reference fields. Media provides an extra layer to store and add metadata related to the files and images.') . '
';
+ $output .= '- ' . t('Existing media items can be reused on any other content items with a media reference field. The file and image reference fields only allow creating new files and images.') . '
';
+ $output .= '
';
return $output;
}
}