Permissions.md

@@ -25,9 +25,11 @@ See [Category] for an example.
 ## Tickets
 
 Apart from read, create, edit and delete actions, there is an additional "set_department" action which will set the value of the cost_bearing_department of a ticket. 
+This is a good example for showing the xml definitions for different agenda, so here is how it's done:
 
 ```
 <transitions>
+	<!-- custom transitions for customers - owner is set automatically and only some attributes may be set-->
 	<transition name="add" description="create ticket" notification="" pre-state="" post-state="" type="create" binding-reference="owning_client">
 		<transition-attribute name="subject" required="true"/>
 		<transition-attribute name="category" required="true"/>
@@ -38,7 +40,7 @@ Apart from read, create, edit and delete actions, there is an additional "set_de
 	</transition>
 	<transition name="purge" description="delete ticket" notification="" pre-state="" post-state="" type="delete" binding-reference="owning_client">
 	</transition>
-
+    <!-- custom transition for accounting -->
 	<transition name="set_department" description="pay the costs" notification="" pre-state="" post-state="" type="edit" binding-reference="cost_bearing_department">
 		<transition-attribute name="cost_bearing_department" required="true"/>
 	</transition>
@@ -46,21 +48,22 @@ Apart from read, create, edit and delete actions, there is an additional "set_de
 
 <agenda name="customer" description="customer creates tickets" binding-module="system" binding-entity="client">
 	<agenda-bindings>
+		<!-- see definitions of transitions above -->
 		<agenda-binding module="helpdesk" entity="ticket" transition="add" />
 		<agenda-binding module="helpdesk" entity="ticket" transition="modify" />
 		<agenda-binding module="helpdesk" entity="ticket" transition="purge" />
 	</agenda-bindings>
 </agenda>
 <agenda name="employee" description="en employee - can see all comments and tickets" binding-module="" binding-entity="">
+	<!-- default transitions - full create/edit/delete rights -->
 	<agenda-bindings>
-		<agenda-binding module="rocks" entity="granite" transition="read" />
-	
 		<agenda-binding module="helpdesk" entity="ticket" transition="create" />
 		<agenda-binding module="helpdesk" entity="ticket" transition="edit" />
 		<agenda-binding module="helpdesk" entity="ticket" transition="delete" />
 	</agenda-bindings>
 </agenda>
 <agenda name="accounting" description="department bound accounting agenda" binding-module="helpdesk" binding-entity="department">
+		<!-- see definitions of transition above -->
 	<agenda-bindings>
 		<agenda-binding module="helpdesk" entity="ticket" transition="set_department" />
 	</agenda-bindings>