diff --git a/core/modules/user/user.module b/core/modules/user/user.module
index 25bbb73..d212f87 100644
--- a/core/modules/user/user.module
+++ b/core/modules/user/user.module
@@ -1038,7 +1038,8 @@ function user_mail_tokens(array &$replacements, array $data, array $options) {
  *   that permission are returned. Defaults to NULL, which returns all roles.
  *
  * @return array
- *   An array of the names of the roles.
+ *   An associative array with the role id as the key and the role name as
+ *   value.
  */
 function user_role_names($membersonly = FALSE, $permission = NULL) {
   return array_map(function ($item) {
@@ -1115,8 +1116,8 @@ function user_user_role_delete(RoleInterface $role) {
  *   (optional) A string containing a permission. If set, only roles containing
  *   that permission are returned. Defaults to NULL, which returns all roles.
  *
- * @return array
- *   An associative array with the role id as the key and the role name as
+ * @return Drupal\user\RoleInterface[]
+ *   An associative array with the role id as the key and the role object as
  *   value.
  */
 function user_roles($membersonly = FALSE, $permission = NULL) {