[wp-trac] [WordPress Trac] #43410: Docs of WP_User::get_role_caps() mix up roles and capabilities

[WordPress Trac]

#43410: Docs of WP_User::get_role_caps() mix up roles and capabilities
--------------------------+-----------------------------
 Reporter:  thomaswm      |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Users         |    Version:
 Severity:  normal        |   Keywords:
  Focuses:  docs          |
--------------------------+-----------------------------
 The documentation of the `WP_User` member function `get_role_caps()` is as
 follows:

   All of the capabilities of the roles the user belongs to are merged with
 the users individual roles. This also means that the user can be denied
 specific roles that their role might have, but the specific user isn’t
 granted permission to.

 This documentation seems confusing to me. I think that roles and
 capabilities are mixed up in two places:

   All of the capabilities of the roles the user belongs to are merged with
 the user's individual ~~roles~~ '''capabilities'''. This also means that
 the user can be denied specific ~~roles~~ '''capabilities''' that their
 role might have, but the specific user isn’t granted permission to.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/43410>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform