Document the effect of multiple role assignments and requirement of completing the matrix

Aldon Hynes@www... - December 6, 2004 - 20:43
Project:Node Moderation
Component:Documentation
Category:task
Priority:normal
Assigned:grohk
Status:closed
Description

When I set up nmoderation on my test machine, I didn't grant permissions to any users, since it was just in test mode, and I only wanted myself ( uid 1 ) to be able to access the module.

I then went to all the configuration screens and filled out every box I could.

Since this didn't include any roles, the moderation matrix and moderation roles were empty so I did nothing with them.

After the votes were set up and I tried to vote, I got an SQL error because there were no values in the moderation matrix.

After I figured out where the problem was, I created an 'admin' role which has permissions to moderate nodes, and filled out the matrix.

Things appear to work okay now.

I would suggest that the documentation should state clearly that you must use user permissions to turn on at least one role before using the module, it may seem obvious, but it isn't

Another thing that needs to be considered. With Drupal 4.5 a user can be in multiple roles. I created a vote called 'good' I set admin's 'good' vote value to 3, and Authenticated User's vote value to 2. I set my id to be both an authenticated user and an admin. It appears to have taken the value from Admin instead of from authenticated user. It would be nice if the documentation would describe how that determination was made.

#1

moshe weitzman - December 6, 2004 - 20:45
Title:Documentation is significantly lacking....» Document the effect of multiple role assignments and requirement of completing the matrix
Category:bug report» task

Setting a more descriptive and positive title

#2

grohk - December 7, 2004 - 15:07
Assigned to:Anonymous» grohk

I think I would like to work on the documentation for these issues.

#3

grohk - December 19, 2004 - 19:40

I tried to address these issues by reworking the readme.txt, please check this and let me know if it is clear enough.

AttachmentSize
readme.txt 4.82 KB

#4

grohk - December 27, 2004 - 05:38

small fixes.

AttachmentSize
nmoderation-readme_1.txt 4.82 KB

#5

grohk - April 12, 2005 - 13:37

Made a patch of the readme with diff. I think this needs to make it into the 4.6 version of the module, so I am changing to CVS.

AttachmentSize
nmoderation_readme.patch 5.29 KB

#6

moshe weitzman - April 12, 2005 - 13:39

thanks brady ... anyone is welcome to commit changes to readme file without consulting me. it is quite unlikely anyone would make it worse.

#7

grohk - April 15, 2005 - 15:34

Thanks Moshe, commited to HEAD.

#8

Anonymous - April 29, 2005 - 16:15
 
 

Drupal is a registered trademark of Dries Buytaert.