diff --git a/core/modules/page_cache/page_cache.info.yml b/core/modules/page_cache/page_cache.info.yml
index af72fab..4affed7 100644
--- a/core/modules/page_cache/page_cache.info.yml
+++ b/core/modules/page_cache/page_cache.info.yml
@@ -1,4 +1,4 @@
-name: Internal page cache
+name: Internal Page Cache
type: module
description: 'Caches pages for anonymous users. Works well for small to medium-sized websites.'
package: Core
diff --git a/core/modules/page_cache/page_cache.module b/core/modules/page_cache/page_cache.module
index 6322363..5791d7b 100644
--- a/core/modules/page_cache/page_cache.module
+++ b/core/modules/page_cache/page_cache.module
@@ -16,18 +16,14 @@ function page_cache_help($route_name, RouteMatchInterface $route_match) {
switch ($route_name) {
case 'help.page.page_cache':
$output = '' . t('About') . '
';
- $output .= '' . t('The Internal page cache module caches pages for anonymous users in the database.') . '
';
+ $output .= '' . t('The Internal Page Cache module caches pages for anonymous users in the database. For more information, see the online documentation for the Internal Page Cache module.', array('!pagecache-documentation' => 'https://www.drupal.org/documentation/modules/internal_page_cache')) . '
';
$output .= '' . t('Uses') . '
';
$output .= '';
$output .= '- ' . t('Speeding up your site') . '
';
- $output .= '- ';
- $output .= '
' . t('Pages requested by anonymous users are stored the first time they are requested and then reused; depending on your site configuration and the amount of your web traffic tied to anonymous visitors, the caching system may significantly increase the speed of your site.');
- $output .= '
' . t('(For authenticated users, pages need to be assembled for each user individually, but anonymous users all get the exact same version of each page.)') . '
';
- $output .= ' ';
- $output .= '- ' . t('Configuring Internal page cache') . '
';
- $output .= '- ';
- $output .= '
' . t('On the Performance settings page, you can configure how long browsers and proxies may cache pages, that setting is also respected by the Internal page cache module. There is no other configuration.', array('@cache-settings' => \Drupal::url('system.performance_settings'))) . '
';
- $output .= ' ';
+ $output .= '- ' . t('Pages requested by anonymous users are stored the first time they are requested and then are re-used. Depending on your site configuration and the amount of your web traffic tied to anonymous visitors, the caching system may significantly increase the speed of your site.') . '
';
+ $output .= '- ' . t('Pages are usually identical for all anonymous users, while they can be customized for each authenticated user. This is why pages can be cached for anonymous users, whereas they will have to be rebuilt for every authenticated user.') . '
';
+ $output .= '- ' . t('Configuring the internal page cache') . '
';
+ $output .= '- ' . t('On the Performance page, you can configure how long browsers and proxies may cache pages; that setting is also respected by the Internal Page Cache module. There is no other configuration.', array('!cache-settings' => \Drupal::url('system.performance_settings'))) . '
';
$output .= '
';
return $output;
diff --git a/core/modules/system/system.module b/core/modules/system/system.module
index 17148be..09d7bc0 100644
--- a/core/modules/system/system.module
+++ b/core/modules/system/system.module
@@ -89,8 +89,8 @@ function system_help($route_name, RouteMatchInterface $route_match) {
$output .= '' . t('The System module provides pages for managing basic site configuration, including Date and time formats and basic Site information (site name, email address to send mail from, home page, and error pages). Additional configuration pages are listed on the main Configuration page.', array('!date-time-settings' => \Drupal::url('entity.date_format.collection'), '!site-info' => \Drupal::url('system.site_information_settings'), '!config' => \Drupal::url('system.admin_config'))) . '';
$output .= '' . t('Using maintenance mode') . '';
$output .= '' . t('When you are performing site maintenance, you can prevent non-administrative users (including anonymous visitors) from viewing your site by putting it in Maintenance mode. This will prevent unauthorized users from making changes to the site while you are performing maintenance, or from seeing a broken site while updates are in progress.', array('!maintenance-mode' => \Drupal::url('system.site_maintenance_mode'))) . '';
- $output .= '' . t('Managing the cache') . '';
- $output .= '' . t('Users with appropriate permission can manage the system cache on the Performance page. If enabled, the cache system will re-use previously-built pages for anonymous page requests, instead of building them again. The site can also be configured to aggregate CSS and JavaScript files, making the total request size smaller. Depending on your site configuration and the amount of web traffic from anonymous visitors, the cache system may significantly increase the speed of your site.', array('!cache-settings' => \Drupal::url('system.performance_settings'))) . '';
+ $output .= '' . t('Handling performance') . '';
+ $output .= '' . t('On the perfomance page, the site can be configured to aggregate CSS and JavaScript files, making the total request size smaller. Note that, for small to medium-sized websites, the Internal Page Cache module should be installed so that pages are efficiently cached and re-used.', array('!performance-page' => \Drupal::url('system.performance_settings'), '!page-cache' => (\Drupal::moduleHandler()->moduleExists('page_cache')) ? \Drupal::url('help.page', array('name' => 'page_cache')) : '#')) . '';
$output .= '' . t('Configuring cron') . '';
$output .= '' . t('In order for the site and its modules to continue to operate well, a set of routine administrative operations must run on a regular basis; these operations are known as cron tasks. On the Cron page, you can configure cron to run periodically as part of normal page requests, or you can turn this off and trigger cron from an outside process on your web server. You can verify the status of cron tasks by visiting the Status report page. For more information, see the online documentation for configuring cron jobs.', array('!status' => \Drupal::url('system.status'), '!handbook' => 'https://www.drupal.org/cron', '!cron' => \Drupal::url('system.cron_settings'))) . '';
$output .= '' . t('Configuring the file system') . '';