Write better Documentation

I agree...

Actually the correct url that one must go to is

http://www.yourdomain.com/?q=admin/user/access

and not

http://www.example.com/?q=admin/access

Secondly, once you are on the Access control page - you must click all of the permission boxes, not only the box to allow permission for anonymous user. This does not make sense because users cant change their role later - so (correct me if im wrong) only "anonymous user" should need permission to access the darn thing... or maybe its all just twisted logic (lol)...

Finally there is one more twist in the logic which i posted elsewhere but just want to reitterate...

function theme_rolelist($roles) {
  $output = t("<p>Please select what type of account you would like to open:</p>");
  $output .= "<ul>\n";
  foreach ($roles as $roleid => $role) {
    if ($role != "authenticated user") { // dont allow selection of authenticated user!
    $url = "user/register/role/".$roleid;
    $output .= "<li>".l($role, $url)."</li>\n";
    }
  }
  $output .= "</ul>\n";
  return $output;
}

I presume just about every webmaster does not want to offer the role of "authenticated user" to be showing up in the list of roles... so I filtered it out. Visitors will be wondering what is "authenticated user" compared to other roles that are self explaitory, such as "manager" or "shop keeper" etc etc.

I provided documentation for Drupal 5 and will continue it from there, with Drupal6 being released I'm not going to backport this module/documentation to 4.7 ... the Handbook page created for the new module is http://drupal.org/node/216868