In Readme, resource-role concept is circularly explained

[MarkDBlackwell]

In section 3.2 "Configure your resource models", the text merely says:

"In the resource models you want to apply roles on, just add resourcify method."

Perhaps this statement contains some circularity. Adding a quick introduction to this functionality would increase its evangelization: in other words, a brief overview would be helpful, here.

[EppO]

In fact, adding resourcify method in your resource models will provide convient methods like explained in section 6. You're definitely right I should make it more clear, maybe referring section 6 in 3.2.
I have to work on the wiki documentation as well as the README file gets really big now...