From aafe521986144bdf7ab1e75ad12e671e158eb4de Mon Sep 17 00:00:00 2001 From: Akita Noek Date: Mon, 15 Feb 2016 12:55:44 -0500 Subject: [PATCH] doc: ImplicitRoleField after the elimination of resource_field Completes #926 --- docs/rbac.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/rbac.md b/docs/rbac.md index 2b0304dd5d..ca7942d16f 100644 --- a/docs/rbac.md +++ b/docs/rbac.md @@ -103,7 +103,16 @@ The `singleton` static method is a helper method on the `Role` model that helps `role_name` is the display name of the role. This is useful when generating reports or looking the results of queries. -`permissions` is a dictionary of set permissions that a user with this role will gain to your `Resource`. A permission defaults to `False` if not explicitly provided. Below is a list of available permissions. The special permission `all` is a shortcut for generating a dict with all of the explicit permissions listed below set to `True`. +`permissions` can be used when the model that contains the +`ImplicitRoleField` utilizs the `ResourceMixin`. When present, a +`RolePermission` entry will be automatically created to grant the specified +permissions on the resource to the role defined by the `ImplicitRoleField`. + +This field should be specified as a dictionary of permissions you wish to +automatically grant. Below is a list of available permissions. The special +permission `all` is a shortcut for generating a dict with all of the explicit +permissions listed below set to `True`. Note that permissions default to +`False` if not explicitly provided. ```python # Available Permissions