Documentation requires usecases

[Routhinator]

The documentation provides many examples of things we can do, with zero context on when, why, or pros and cons of each. Like, why would I use a RuleSet? What's the purpose of this feature? When should I use rules vs perms? What's the best way to implement rules in a DRY manner across multiple subapps in a Django project?

[dfunckt]

@Routhinator I'll admit the README can be improved, but I'm pretty sure it answers all these questions on a careful read. What parts are unclear?