Complete docblocks

Author: schlessera

src/Capabilities_Command.php

@@ -23,6 +23,11 @@
  */
 class Capabilities_Command extends WP_CLI_Command {
 
+	/**
+	 * List of available fields.
+	 *
+	 * @var array
+	 */
 	private $fields = [ 'name' ];
 
 	/**
@@ -199,6 +204,13 @@ public function remove( $args ) {
 		WP_CLI::success( sprintf( $message, $count, $role ) );
 	}
 
+	/**
+	 * Retrieve a specific role from the system.
+	 *
+	 * @param string $role Role to retrieve.
+	 * @return WP_Role Requested role.
+	 * @throws \WP_CLI\ExitException If the role could not be found.
+	 */
 	private static function get_role( $role ) {
 		global $wp_roles;
 
@@ -211,6 +223,12 @@ private static function get_role( $role ) {
 		return $role_obj;
 	}
 
+	/**
+	 * Assert that the roles are persisted to the database.
+	 *
+	 * @throws \WP_CLI\ExitException If the roles are not persisted to the
+	 *                               database.
+	 */
 	private static function persistence_check() {
 		global $wp_roles;
 

src/Role_Command.php

@@ -39,9 +39,18 @@
  */
 class Role_Command extends WP_CLI_Command {
 
+	/**
+	 * Available fields.
+	 *
+	 * @var array
+	 */
 	private $fields = [ 'name', 'role' ];
 
-	// Array of default roles.
+	/**
+	 * Default roles ad provided by WordPress Core.
+	 *
+	 * @var array
+	 */
 	private $roles = [ 'administrator', 'editor', 'author', 'contributor', 'subscriber' ];
 
 	/**
@@ -377,6 +386,12 @@ public function reset( $args, $assoc_args ) {
 		}
 	}
 
+	/**
+	 * Assert that the roles are persisted to the database.
+	 *
+	 * @throws \WP_CLI\ExitException If the roles are not persisted to the
+	 *                               database.
+	 */
 	private static function persistence_check() {
 		global $wp_roles;