Problem/Motivation
The hook_user_role_*() docs in user.api.php are not consistent with other documentation like hook_node_insert(). @Dave Reid pointed out in #1119158-6: user_role_save() doesn't implement a presave hook that these usually start with "Act on…".
Proposed resolution
Update the docblocks of these hooks.
Remaining tasks
| Task | Novice task? | Contributor instructions | Complete? |
|---|---|---|---|
| Create a patch | Yes | Instructions | No |
User interface changes
n/a
API changes
n/a
Original report by @skwashd
Some of the language in user.api.inc is a little clunky and not consistent with others parts of core. This was raised during the review of #1119158: user_role_save() doesn't implement a presave hook.
An example of this is the docs for the hook_user_role_*() functions.
/**
* Inform other modules that a user role has been added.
*
...