extending permission docs

docs/permissions.md

@@ -11,9 +11,9 @@ If you want to change permissions for specific roles or users, or even create ne
 In short, these are the roles and their main characteristics. A detailed description can be found in the next session. 
 
 * Subscriber: Can't really do anything inside tainacan.
-* Colaborator / Tainacan Colaborator: Can create items, but not to publish them.
+* Colaborator / Tainacan Colaborator: Can create collections and items, but not to publish them.
-* Author / Tainacan Author: Can create and publish items, but can not edit published items nor edit other user's items.
+* Author / Tainacan Author: Can create and publish collections and items, but can not edit published items nor edit other user's items.
-* Editor / Tainacan Editor: Can create, publish and edit other users's items.
+* Editor / Tainacan Editor: Can create, publish and edit other users's collections and items.
 * Administrator: Rules the world.
 
 ## Roles and permissions
@@ -44,35 +44,35 @@ These are the capabilities related to collection management.
 > Capability name: edit_tainacan-collections
 Who's got it: Everyone but subscribers
 
-Allows to create and edit one's own collections. Does not allow to publish them.
+Allows to create and edit one's own collections details. Does not allow to publish them.
 
 #### Edit Others Collections
 
 > Capability name: edit_others_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to edit other user's Collections (and items)
+Allows to edit other user's Collections details.
 
 #### Edit Published Collections
 
 > Capability name: edit_published_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to edit collections details after it was published
+Allows to edit collections details after they were published.
 
 #### Edit Private Collections
 
 > Capability name: edit_private_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to edit collections marked as private
+Allows to edit details of collections marked as private.
 
 #### Publish Collections
 
 > Capability name: publish_tainacan-collections
 Who's got it: Administrators, Editors, Tainacan Editors, Authors and Tainacan Authors
 
-Allows to edit collections marked as private
+Allows to publish one's own collections.
 
 #### Delete Collections
 
@@ -86,21 +86,21 @@ Allows to delete one's own collections.
 > Capability name: delete_others_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to delete other user's Collections (and items)
+Allows to delete other user's Collections.
 
 #### Delete Published Collections
 
 > Capability name: delete_published_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to delete collections after it was published
+Allows to delete collections after they were published.
 
 #### Delete Private Collections
 
 > Capability name: delete_private_tainacan-collections
 Who's got it: Administrators, Editors and Tainacan Editors
 
-Allows to delete collections marked as private
+Allows to delete collections marked as private.
 
 #### Read Private Collections
 
@@ -111,6 +111,102 @@ Allows to view collections marked as private and its items.
 
 ### Items
 
+These are the capabilities related to items management.
+
+Every user in tainacan is granted a set of capabilities, for every collection in the repository, depending on his/her role.
+
+Capabilities are independent for each collection. So a user may be editor in one collection but have no rights whatsoever in another collection.
+
+Permissions to a specific collection may be granted to a user adding him/her as a moderator of the collection. In that case, he/she will have the same rights as an editor, but only for that specific collection.
+
+Also, you may use a WordPress plugin to have granular control of capabilities for each user in each collection.
+
+In the description below you will find the characteristics of all the capabilities that are applied for each collection. Each user and role have a set of all these 10 capabilities for each collection.
+
+|                        | Admin | Editor | Author | Collaborator |
+|------------------------|-------|--------|--------|--------------|
+| Edit Items             | y     | y      | y      | y            |
+| Delete Items           | y     | y      | y      | y            |
+| Publish Items          | y     | y      | y      |              |
+| Edit Published Items   | y     | y      | y      |              |
+| Delete Published Items | y     | y      | y      |              |
+| Edit Others Items      | y     | y      |        |              |
+| Delete Others Items    | y     | y      |        |              |
+| Read Private Items     | y     | y      |        |              |
+| Edit Private Items     | y     | y      |        |              |
+| Delete Private Items   | y     | y      |        |              |
+
+#### Edit Items
+
+> Capability name: edit_%collection_id%_items
+Who's got it: Everyone but subscribers
+
+Allows to create and edit one's own items. Does not allow to publish them.
+
+#### Edit Others Items
+
+> Capability name: edit_others_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to edit other user's Items.
+
+#### Edit Published Items
+
+> Capability name: edit_published_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to edit Items after they were published.
+
+#### Edit Private Items
+
+> Capability name: edit_private_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to edit Items marked as private.
+
+#### Publish Items
+
+> Capability name: publish_%collection_id%_items
+Who's got it: Administrators, Editors, Tainacan Editors, Authors and Tainacan Authors
+
+Allows to publish one's own Items.
+
+#### Delete Items
+
+> Capability name: delete_%collection_id%_items
+Who's got it: Everyone but subscribers
+
+Allows to delete one's own Items.
+
+#### Delete Others Items
+
+> Capability name: delete_others_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to delete other user's Items.
+
+#### Delete Published Items
+
+> Capability name: delete_published_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to delete Items after they were published.
+
+#### Delete Private Items
+
+> Capability name: delete_private_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to delete Items marked as private.
+
+#### Read Private Items
+
+> Capability name: read_private_%collection_id%_items
+Who's got it: Administrators, Editors and Tainacan Editors
+
+Allows to view Items marked as private and its items.
+
+
 ### Categories
 
 ### Fields