Rename OpenEvent to AccessEvent as discussed on IRC

Document all event- manifestations and interpretations

1 files changed, 21 insertions, 7 deletions

diff --git a/extra/ontology/zeo.trig b/extra/ontology/zeo.trig
index 2bf4e76d..ea10c7c1 100644
--- a/extra/ontology/zeo.trig
+++ b/extra/ontology/zeo.trig
@@ -18,11 +18,12 @@ zg: {
     
     zg:Event
         a rdfs:Class ;
+        rdfs:comment "Something that happened at a point in time. Events are categorized by two primary factors 'what happened' - called the interpretation and 'how did it happen' - called the manifestation. Aside from a timestamp, events can also carry a reference to the entity responsible for instantiating it - called the actor. Normally the event actor is an application, but it need not be. Events happen to zero or more subjects. The subjects are described using the Nepomuk ontologies." ;
         rdfs:subClassOf rdfs:Resource .
     
     zg:EventInterpretation
         a   rdfs:Class ;
-        rdfs:comment "" ;
+        rdfs:comment "Base class for event interpretations. Please do no instantiate directly, but use one of the sub classes" ;
         rdfs:subClassOf nie:InformationElement .
     
     zg:CreateEvent
@@ -31,52 +32,65 @@ zg: {
         rdfs:label "Created" ; 
         rdfs:subClassOf zg:EventInterpretation .
     
-    zg:OpenEvent
+    zg:AccessEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered by opening, accessing, or starting a resource. Most zg:AccessEvents will have an accompanying zg:LeaveEvent, but this need not always be the case" ;
         rdfs:subClassOf zg:EventInterpretation .
     
-    zg:ModifyEvent
+    zg:LeaveEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered by closing, leaving, or stopping a resource. Most zg:LeaveEvents will be following a zg:Access event, but this need not always be the case" ;
         rdfs:subClassOf zg:EventInterpretation .
-    
-    zg:DeleteEvent
+
+    zg:ModifyEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered by modifying an existing resources. Fx. when editing and saving a file on disk or correcting a typo in the name of a contact" ;
         rdfs:subClassOf zg:EventInterpretation .
     
-    zg:CloseEvent
+    zg:DeleteEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered because a resource has been deleted or otherwise made permanently unavailable. Fx. when deleting a file. FIXME: How about when moving to trash?" ;
         rdfs:subClassOf zg:EventInterpretation .
         
     zg:ReceiveEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered when something is received from an external party. The event manifestation must be set according to the world view of the receiving party. Most often the item that is being received will be some sort of message - an email, instant message, or broadcasted media such as micro blogging" ;
         rdfs:subClassOf zg:EventInterpretation .
     
     zg:SendEvent
         a rdfs:Class ;
+        rdfs:comment "Event triggered when something is send to an external party. The event manifestation must be set according to the world view of the sending party. Most often the item that is being send will be some sort of message - an email, instant message, or broadcasted media such as micro blogging" ;
+        rdfs:comment "Event triggered by" ;
         rdfs:subClassOf zg:EventInterpretation .
     
     zg:EventManifestation
         a   rdfs:Class ;
+        rdfs:comment "Base class for event manifestation types. Please do no instamtiate directly, but use one of the sub classes" ;
         rdfs:subClassOf nie:DataObject .
     
     zg:UserActivity
         a rdfs:Class ;
+        rdfs:comment "An event that was actively performed by the user. For example saving or opening a file by clicking on it in the file manager" ;
         rdfs:subClassOf zg:EventManifestation .
     
     zg:HeuristicActivity
         a rdfs:Class ;
+        rdfs:comment "An event that is caused indirectly from user activity or deducted via analysis of other events. Fx. if an algorithm divides a user workflow into disjoint 'projects' based on temporal analysis it could insert heuristic events when the user changed project" ;
         rdfs:subClassOf zg:EventManifestation .
     
     zg:ScheduledActivity
         a rdfs:Class ;
+        rdfs:comment "An event that was directly triggered by some user initiated sequence of actions. For example a music player automatically changing to the next song in a playlist" ;
         rdfs:subClassOf zg:EventManifestation .
     
     zg:WorldActivity
         a rdfs:Class ;
+        rdfs:comment "An event that was performed by an entity, usually human or organization, other than the user. An example could be logging the activities of other people in a team" ;
         rdfs:subClassOf zg:EventManifestation .
     
     zg:SystemNotification
         a rdfs:Class ;
+        rdfs:comment "An event send to the user by the operating system. Examples could include when the user inserts a USB stick or when the system warns that the hard disk is full" ;
         rdfs:subClassOf zg:EventManifestation .
     
     zg:eventId
@@ -97,7 +111,7 @@ zg: {
     
     zg:hasActor
         a   rdfs:Property ;
-        rdfs:comment "The entity responsible for generating the event" ;
+        rdfs:comment "The application or entity responsible for emitting the event. For applications the format of this field is the base filename of the corresponding .desktop file with an app:// URI scheme. For example /usr/share/applications/firefox.desktop is encoded as app://firefox.desktop" ;
         rdfs:domain zg:Event ;
         rdfs:range rdfs:Resource ;
         rdfs:label "actor" ;