From 983fa97703d903e1abff4feb4797acb8e78eb2ec Mon Sep 17 00:00:00 2001
From: "Robert L. Huffstedtler" <rhuffstedtler@gmail.com>
Date: Wed, 3 Jun 2015 21:13:39 -0400
Subject: [PATCH] Issue #1831798 by rhuffstedtler. Fixes per issue comments and
 some rewrites to make more consistent with other help pages.

---
 core/modules/config/config.module | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/core/modules/config/config.module b/core/modules/config/config.module
index 05f4b6d..011cbaf 100644
--- a/core/modules/config/config.module
+++ b/core/modules/config/config.module
@@ -15,14 +15,18 @@ function config_help($route_name, RouteMatchInterface $route_match) {
     case 'help.page.config':
       $output = '';
       $output .= '<h3>' . t('About') . '</h3>';
-      $output .= '<p>' . t('The Configuration manager module provides a user interface for importing and exporting configuration changes; i.e., for staging configuration data between multiple instances of this web site. For more information, see the online handbook entry for <a href="!url">Configuration manager module</a>', array(
-        '!url' => 'https://www.drupal.org/documentation/administer/config',
-      )) . '</p>';
-      return $output;
-
-    case 'config.sync':
-      $output = '';
-      $output .= '<p>' . t('Import configuration that is placed in your staging directory. All changes, deletions, renames, and additions are listed below.') . '</p>';
+      $output .= '<p>' . t('The Configuration Manager module provides a user interface for importing and exporting configuration changes between installations of your website in different environments, such as development, staging, and production.') . '</p>';
+      $output .= '<p>' . t('Configuration Manager allows you to deploy configuration from one environment to another, provided they are the same site. The site is identified using a Universally Unique Identifier (UUID). The site UUID must match the target site to allow any importing of configuration files on that site.') . '</p>';
+      $output .= '<p>' . t('For more information, see the online documentation for the <a href="!url">Configuration Manager module</a>', array( '!url' => 'https://www.drupal.org/documentation/administer/config',)) . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Exporting configuration') . '</dt>';
+      $output .= '<dd>' . t('Users with the <em>Export configuration</em> permission can <a href="!full">create a downloadable archive of the entire active site configuration</a> or <a href="!single">view a yml export of a single configuration item</a>.</dd>', array( '!full' => '/admin/config/development/configuration/full/export', "!single" => '/admin/config/development/configuration/single/export',));
+      $output .= '<dt>' . t('Synchronizing configuration'). '</dt>';
+      $output .= '<dd>' . t('Users with the <em>Synchronize configuration</em> permission can <a href="!sync">review differences between the active configuration and a staged configuration</a>. The Synchronize page also shows new or removed config files. It is important to check that there are no removals of any core configuration (such as system.*, entity.*) as this will result in a site error.</dd>', array('!sync' => '/admin/config/development/configuration',));
+      $output .= '<dt>' . t('Importing configuration') . '</dt>';
+      $output .= '<dd>' . t('Users with the <em>Import configuration</em> permission can <a href="!full">upload a full site configuration from an archive file</a> or <a href="!single">paste yml for a single configuration item into a form</a>.</dd>', array('!full' => '/admin/config/development/configuration/full/import','!single' => '/admin/config/development/configuration/single/import',));
+      $output .= '</dl>';
       return $output;
   }
 }
-- 
1.8.1.msysgit.1