Docs of WP_User::get_role_caps() mix up roles and capabilities

[thomaswm]

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.

[thomaswm]

Documentation was added in [8904].

[thomaswm]

Patch

[SergeyBiryukov]

In 42735:

Docs: Correct description for WP_User::get_role_caps().

Props thomaswm.
Fixes #43410.

[SergeyBiryukov]

Switching milestone due to the focus on the new editor (Gutenberg) for WordPress 5.0.