Merge pull request #83 from hearvox/master

Improve top-level commands; add reference links

Author: schlessera

README.md

@@ -13,7 +13,7 @@ This package implements the following commands:
 
 ### wp comment
 
-Manage comments.
+Creates, updates, deletes, and moderates comments.
 
 ~~~
 wp comment
@@ -72,7 +72,7 @@ wp comment meta
 
 ### wp menu
 
-List, create, assign, and delete menus.
+Lists, creates, assigns, and deletes the active theme's navigation menus.
 
 ~~~
 wp menu
@@ -182,7 +182,7 @@ wp network meta
 
 ### wp option
 
-Manage options.
+Retrieves and sets site options, including plugin and WordPress settings.
 
 ~~~
 wp option
@@ -471,7 +471,7 @@ wp option update <key> [<value>] [--autoload=<autoload>] [--format=<format>]
 
 ### wp post
 
-Manage posts.
+Manages posts, content, and meta.
 
 ~~~
 wp post
@@ -543,7 +543,7 @@ wp post term
 
 ### wp post-type
 
-Manage post types.
+Retrieves details on the site's registered post-types.
 
 ~~~
 wp post-type
@@ -570,7 +570,7 @@ wp post-type
 
 ### wp site
 
-Perform site-wide operations.
+Performs site-wide operations on a multisite install.
 
 ~~~
 wp site
@@ -639,7 +639,7 @@ WP_CLI::add_hook( 'after_invoke:site empty', function(){
 
 ### wp taxonomy
 
-Manage taxonomies.
+Retrieves information about registered taxonomies.
 
 ~~~
 wp taxonomy
@@ -665,7 +665,7 @@ wp taxonomy
 
 ### wp term
 
-Manage terms.
+Manages taxonomy terms and term meta, including create, delete, and list.
 
 ~~~
 wp term
@@ -732,7 +732,7 @@ wp term meta
 
 ### wp user
 
-Manage users.
+Manages users, along with their roles, capabilities, and meta.
 
 ~~~
 wp user

src/Comment_Command.php

@@ -3,7 +3,7 @@
 use WP_CLI\Utils;
 
 /**
- * Manage comments.
+ * Creates, updates, deletes, and moderates comments.
  *
  * ## EXAMPLES
  *

src/Menu_Command.php

@@ -5,6 +5,8 @@
 /**
  * Lists, creates, assigns, and deletes the active theme's navigation menus.
  *
+ * See the [Navigation Menus](https://developer.wordpress.org/themes/functionality/navigation-menus/) reference in the Theme Handbook.
+ *
  * ## EXAMPLES
  *
  *     # Create a new menu

src/Option_Command.php

@@ -4,7 +4,9 @@
 use WP_CLI\Utils;
 
 /**
- * Manage options.
+ * Retrieves and sets site options, including plugin and WordPress settings.
+ *
+ * See the [Plugin Settings API](https://developer.wordpress.org/plugins/settings/settings-api/) and the [Theme Options](https://developer.wordpress.org/themes/customize-api/) for more information on adding customized options.
  *
  * ## EXAMPLES
  *

src/Post_Type_Command.php

@@ -1,6 +1,8 @@
 <?php
 /**
- * Retrieves details on the site's registered post-types.
+ * Retrieves details on the site's registered post types.
+ *
+ * Get information on WordPress' built-in and the site's [custom post types](https://developer.wordpress.org/plugins/post-types/).
  *
  * ## EXAMPLES
  *

src/Site_Command.php

@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Perform site-wide operations.
+ * Performs site-wide operations on a multisite install.
  *
  * ## EXAMPLES
  *

src/Taxonomy_Command.php

@@ -1,6 +1,8 @@
 <?php
 /**
- * Manage taxonomies.
+ * Retrieves information about registered taxonomies.
+ *
+ * See references for [built-in taxonomies](https://developer.wordpress.org/themes/basics/categories-tags-custom-taxonomies/) and [custom taxonomies](https://developer.wordpress.org/plugins/taxonomies/working-with-custom-taxonomies/).
  *
  * ## EXAMPLES
  *

src/Term_Command.php

@@ -3,7 +3,9 @@
 use WP_CLI\Utils;
 
 /**
- * Manage terms.
+ * Manages taxonomy terms and term meta, with create, delete, and list commands.
+ *
+ * See reference for [taxonomies and their terms](https://codex.wordpress.org/Taxonomies).
  *
  * ## EXAMPLES
  *

src/User_Command.php

@@ -3,7 +3,9 @@
 use \WP_CLI\Utils;
 
 /**
- * Manage users.
+ * Manages users, along with their roles, capabilities, and meta.
+ *
+ * See references for [Roles and Capabilities](https://codex.wordpress.org/Roles_and_Capabilities) and [WP User class](https://codex.wordpress.org/Class_Reference/WP_User).
  *
  * ## EXAMPLES
  *