Commit a3e9b35a authored by Dries's avatar Dries
Browse files

- Patch #19451 by JonBob: improved consistency of module descriptions. We...

- Patch #19451 by JonBob: improved consistency of module descriptions.  We should write guidelines for this -- maybe in the PHPDoc code of the _help hook.
parent 71c021c6
......@@ -58,7 +58,7 @@ function aggregator_help($section) {
<p>When fetching feeds Drupal supports conditional GETs, this reduces the bandwidth usage for feeds that have not been updated since the last check.</p>
<p>If a feed is permanently moved to a new location Drupal will automatically update the feed URL to the new address.</p>', array('%block' => url('admin/block'), '%admin-news' => url('admin/aggregator'), '%new-feed' => url('admin/aggregator/add/feed'), '%new-category' => url('admin/aggregator/add/category'), '%update-items' => url('admin/aggregator'), '%news-aggregator' => url('aggregator'), '%sources' => url('aggregator/sources'), '%categories' => url('aggregator/categories')));
case 'admin/modules#description':
return t('Used to aggregate syndicated content (RSS and RDF).');
return t('Aggregates syndicated content (RSS and RDF feeds).');
case 'admin/aggregator':
return t('<p>Thousands of sites (particularly news sites and weblogs) publish their latest headlines and/or stories in a machine-readable format so that other sites can easily link to them. This content is usually in the form of an <a href="http://blogs.law.harvard.edu/tech/rss">RSS</a> feed (which is an XML-based syndication standard). To display the feed or category in a block you must decide how many items to show by editing the feed or block and turning on the <a href="%block">feed\'s block</a>.</p>', array('%block' => url('admin/block')));
case 'admin/aggregator/add/feed':
......
......@@ -58,7 +58,7 @@ function aggregator_help($section) {
<p>When fetching feeds Drupal supports conditional GETs, this reduces the bandwidth usage for feeds that have not been updated since the last check.</p>
<p>If a feed is permanently moved to a new location Drupal will automatically update the feed URL to the new address.</p>', array('%block' => url('admin/block'), '%admin-news' => url('admin/aggregator'), '%new-feed' => url('admin/aggregator/add/feed'), '%new-category' => url('admin/aggregator/add/category'), '%update-items' => url('admin/aggregator'), '%news-aggregator' => url('aggregator'), '%sources' => url('aggregator/sources'), '%categories' => url('aggregator/categories')));
case 'admin/modules#description':
return t('Used to aggregate syndicated content (RSS and RDF).');
return t('Aggregates syndicated content (RSS and RDF feeds).');
case 'admin/aggregator':
return t('<p>Thousands of sites (particularly news sites and weblogs) publish their latest headlines and/or stories in a machine-readable format so that other sites can easily link to them. This content is usually in the form of an <a href="http://blogs.law.harvard.edu/tech/rss">RSS</a> feed (which is an XML-based syndication standard). To display the feed or category in a block you must decide how many items to show by editing the feed or block and turning on the <a href="%block">feed\'s block</a>.</p>', array('%block' => url('admin/block')));
case 'admin/aggregator/add/feed':
......
......@@ -12,7 +12,7 @@
function archive_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Displays a calendar to navigate old content.');
return t('Displays a calendar for navigating older content.');
}
}
......
......@@ -12,7 +12,7 @@
function archive_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Displays a calendar to navigate old content.');
return t('Displays a calendar for navigating older content.');
}
}
......
......@@ -14,7 +14,7 @@ function blogapi_help($section) {
case 'admin/help#blogapi':
return t('<p>This module adds support for several XML-RPC based blogging APIs. Specifically, it currently implements the %bloggerAPI, %metaweblogAPI, and most of the %moveabletype extensions. This allows users to contribute to Drupal using external GUI applications, which can often offer richer functionality that online forms based editing.</p><p>This module also allows site administrators to configure which node types can be posted via the external applications. So, for instance, users can post forum topics as well as blog posts. Where supported, the external applications will display each node type as a separate "blog".</p>', array('%bloggerAPI' => '<a href="http://www.blogger.com/developers/api/1_docs/">Blogger API</a>', '%metaweblogAPI' => '<a href="http://www.xmlrpc.com/metaWeblogApi">MetaWeblog API</a>', '%moveabletype' => '<a href="http://www.movabletype.org/docs/mtmanual_programmatic.html">Movable Type API</a>. '));
case 'admin/modules#description':
return t('Enable users to post using applications that support XML-RPC blog APIs.');
return t('Allows users to post content using applications that support XML-RPC blog APIs.');
}
}
......
......@@ -14,7 +14,7 @@ function blogapi_help($section) {
case 'admin/help#blogapi':
return t('<p>This module adds support for several XML-RPC based blogging APIs. Specifically, it currently implements the %bloggerAPI, %metaweblogAPI, and most of the %moveabletype extensions. This allows users to contribute to Drupal using external GUI applications, which can often offer richer functionality that online forms based editing.</p><p>This module also allows site administrators to configure which node types can be posted via the external applications. So, for instance, users can post forum topics as well as blog posts. Where supported, the external applications will display each node type as a separate "blog".</p>', array('%bloggerAPI' => '<a href="http://www.blogger.com/developers/api/1_docs/">Blogger API</a>', '%metaweblogAPI' => '<a href="http://www.xmlrpc.com/metaWeblogApi">MetaWeblog API</a>', '%moveabletype' => '<a href="http://www.movabletype.org/docs/mtmanual_programmatic.html">Movable Type API</a>. '));
case 'admin/modules#description':
return t('Enable users to post using applications that support XML-RPC blog APIs.');
return t('Allows users to post content using applications that support XML-RPC blog APIs.');
}
}
......
......@@ -75,7 +75,7 @@ function comment_help($section = "admin/help#comment") {
case 'admin/comment/configure/votes':
return t('<p>Create and control the possible comment moderation votes here. "Weight" lets you set the order of the drop down menu. Click "edit" to edit a current vote weight. To delete a name/weight combination go to the "edit" area. To delete a setting, "edit" it first, and then choose "delete vote".</p>');
case 'admin/modules#description':
return t('Enables user to comment on published content.');
return t('Allows users to comment on and discuss published content.');
}
}
......
......@@ -75,7 +75,7 @@ function comment_help($section = "admin/help#comment") {
case 'admin/comment/configure/votes':
return t('<p>Create and control the possible comment moderation votes here. "Weight" lets you set the order of the drop down menu. Click "edit" to edit a current vote weight. To delete a name/weight combination go to the "edit" area. To delete a setting, "edit" it first, and then choose "delete vote".</p>');
case 'admin/modules#description':
return t('Enables user to comment on published content.');
return t('Allows users to comment on and discuss published content.');
}
}
......
......@@ -23,7 +23,7 @@
function filter_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Framework for handling filtering of content.');
return t('Handles the filtering of content in preparation for display.');
case 'admin/filters':
return t('
......
......@@ -23,7 +23,7 @@
function filter_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Framework for handling filtering of content.');
return t('Handles the filtering of content in preparation for display.');
case 'admin/filters':
return t('
......
......@@ -18,7 +18,7 @@ function forum_help($section) {
case 'admin/forum/add/forum':
return t('<p>A forum holds threaded topic discussions that are related. For example, a forum named "Fruit" might contain topic discussions titled "Apples" and "Bananas". You can place a forum into a container, another forum, or at the top (root) level of your forum.</p>');
case 'admin/modules#description':
return t('Enable threaded discussions about general topics.');
return t('Enables threaded discussions about general topics.');
case 'node/add#forum':
return t('A forum is a threaded discussion, enabling users to communicate about a particular topic.');
}
......
......@@ -18,7 +18,7 @@ function forum_help($section) {
case 'admin/forum/add/forum':
return t('<p>A forum holds threaded topic discussions that are related. For example, a forum named "Fruit" might contain topic discussions titled "Apples" and "Bananas". You can place a forum into a container, another forum, or at the top (root) level of your forum.</p>');
case 'admin/modules#description':
return t('Enable threaded discussions about general topics.');
return t('Enables threaded discussions about general topics.');
case 'node/add#forum':
return t('A forum is a threaded discussion, enabling users to communicate about a particular topic.');
}
......
......@@ -85,7 +85,7 @@ function help_links_as_list() {
function help_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Manages displaying online help.');
return t('Manages the display of online help.');
}
}
......
......@@ -85,7 +85,7 @@ function help_links_as_list() {
function help_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Manages displaying online help.');
return t('Manages the display of online help.');
}
}
......
......@@ -40,7 +40,7 @@ function node_help($section) {
return $output;
case 'admin/modules#description':
return t('The core that allows content to be submitted to the site.');
return t('Allows content to be submitted to the site and displayed on pages.');
case 'admin/node/configure':
case 'admin/node/configure/settings':
return t('<p>Settings for the core of Drupal. Almost everything is a node so these settings will affect most of the site.</p>');
......
......@@ -40,7 +40,7 @@ function node_help($section) {
return $output;
case 'admin/modules#description':
return t('The core that allows content to be submitted to the site.');
return t('Allows content to be submitted to the site and displayed on pages.');
case 'admin/node/configure':
case 'admin/node/configure/settings':
return t('<p>Settings for the core of Drupal. Almost everything is a node so these settings will affect most of the site.</p>');
......
......@@ -12,7 +12,7 @@
function path_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Enables users to rename URLs.');
return t('Allows users to rename URLs.');
case 'admin/path':
return t("<p>Drupal provides users complete control over URLs through aliasing. This feature is typically used to make URLs human-readable or easy to remember. For example, one could map the relative URL 'node/1' onto 'about'. Each system path can have multiple aliases.</p>");
case 'admin/path/add':
......
......@@ -12,7 +12,7 @@
function path_help($section) {
switch ($section) {
case 'admin/modules#description':
return t('Enables users to rename URLs.');
return t('Allows users to rename URLs.');
case 'admin/path':
return t("<p>Drupal provides users complete control over URLs through aliasing. This feature is typically used to make URLs human-readable or easy to remember. For example, one could map the relative URL 'node/1' onto 'about'. Each system path can have multiple aliases.</p>");
case 'admin/path/add':
......
......@@ -18,7 +18,7 @@ function ping_help($section) {
break;
case 'admin/modules#description':
$output = t('Alerts other sites that your site has been updated.');
$output = t('Alerts other sites when your site has been updated.');
break;
}
......
......@@ -18,7 +18,7 @@ function ping_help($section) {
break;
case 'admin/modules#description':
$output = t('Alerts other sites that your site has been updated.');
$output = t('Alerts other sites when your site has been updated.');
break;
}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment