Docs: Switch more docs over to typed array notation, plus some fixes.

See #48303, #41756


git-svn-id: https://develop.svn.wordpress.org/trunk@46596 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/class-wp-role.php

@@ -37,8 +37,9 @@ class WP_Role {
 	 *
 	 * @since 2.0.0
 	 *
-	 * @param string $role Role name.
-	 * @param array $capabilities List of capabilities.
+	 * @param string $role         Role name.
+	 * @param bool[] $capabilities List of capabilities keyed by the capability name,
+	 *                             e.g. array( 'edit_posts' => true, 'delete_posts' => false ).
 	 */
 	public function __construct( $role, $capabilities ) {
 		$this->name         = $role;