Usability problem: implement hook_enable to tell admins where and how to configure module when enabled

Agreed - this is a huge usability oversight :(

The readme.txt for this module says:

INSTALLATION

...

If you don't already have an existing role named 'admin' or 'administrator',
the module will automatically create one for you on install. Otherwise, you can
go to your Admin > Users > User Settings (admin/user/settings) page and select
your preferred admin role under the 'Administrator role' fieldset.

Now when you add a new module, your assigned role will automatically receive
any new available permissions!

For this module to be intuitive - i.e. fire and forget, I'd like to propose that the install process works like this:

- module is enabled in admin/build/modules;
- hook_enable should be used to display a message to the user telling them that the Admin Role module is now installed;
- the module should check for an admin or administrator role
-- if no admin or administrator role is present, create the role and issue a drupal_set_message informing the admin
-- then assign all permissions to that role and display a message informing the user of this fact
- whenever ANY new module is installed, this module should display a drupal_set_message telling the user which new permissions have been assigned to the admin(istrator) role

I think this is a great module, but its lack of feedback makes it infuriatingly difficult to know whether it's actually working or not!

(Edited as I overlooked a detail in my original post)

Hooray people can read the readmes!

I'm not a big fan of modules popping up messages on install just to point people where it should be configured since that's what documentation is for, but I do see the point of adding a message when the administrator role is added by the module on install, so I've added one to CVS.