--- a/schema.org/ext/Actions2013-base.html Wed Jul 24 13:06:12 2013 +0200
+++ b/schema.org/ext/Actions2013-base.html Wed Jul 24 15:52:30 2013 +0200
@@ -5,8 +5,7 @@
</head>
<body>
<!-- todo: restore nicer CSS -->
-<!-- to verify schema graph after edits, use rapper -q -i rdfa Actions2013-actiontypes.html
-or http://www.w3.org/2012/pyRdfa/#distill_by_input -->
+<!-- to verify schema graph after edits, use rapper -q -i rdfa Actions2013-actiontypes.html or http://www.w3.org/2012/pyRdfa/#distill_by_input -->
<div class="type" typeof="rdfs:Class" resource="http://schema.org/Action">
@@ -15,9 +14,7 @@
<p class="narrow"><strong>Subclass of:</strong> <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></p>
-<p class="description" property="rdfs:comment">An action (past, present, future or potential) performed by some entity; typically on some other 'object', sometimes 'performedWith' a tool or person, and having some 'target' and/or 'result'. Specific action sub-type documentation specifies the exact meaning of such Action roles in each case.</p>
-
-
+<p class="description" property="rdfs:comment">An action performed by a direct agent and indirect participants upon a direct object, starting at an origin towards a destination. Happens at a location, with the help of an inanimate instrument. The execution of the action may produce a result. Specific action sub-type documentation specifies the exact expectation of each argument/role/slot.</p>
<table class="properties" border="1" cellpadding="10">
@@ -26,143 +23,76 @@
<tr><td class="section" colspan="3">Properties added by Action</td></tr>
-<tr typeof="rdf:Property" href="http://schema.org/performedBy">
-<th property="rdfs:label">performedBy</th>
+<tr typeof="rdf:Property" href="http://schema.org/agent">
+<th property="rdfs:label">agent</th>
<td>
-
-<!-- we don't show the domain, as it is always Action -->
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-
-<!-- but we do show the range, as expected value varies with each property -->
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-
+ <link property="http://schema.org/domain" href="http://schema.org/Action"></link> <!-- we don't show the domain, as it is always Action -->
+ <a property="http://schema.org/range" href="http://schema.org/Person">Person</a>, <!-- but we do show the range, as expected value varies with each property -->
+ <a property="http://schema.org/range" href="http://schema.org/Organization">Organization</a>
</td>
-<td property="rdfs:comment">The entity that performed the Action.</td>
+<td property="rdfs:comment">The direct performer or driver of the action (animate or inanimate). E.g. *John* wrote a book.</td>
</tr>
-<tr typeof="rdf:Property" resource="http://schema.org/performedWith">
-<th property="rdfs:label">performedWith</th>
+
+<tr typeof="rdf:Property" href="http://schema.org/participant">
+<th property="rdfs:label">participant</th>
<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
+ <link property="http://schema.org/domain" href="http://schema.org/Action"></link> <!-- we don't show the domain, as it is always Action -->
+ <a property="http://schema.org/range" href="http://schema.org/Person">Person</a>, <!-- but we do show the range, as expected value varies with each property -->
+ <a property="http://schema.org/range" href="http://schema.org/Organization">Organization</a>
</td>
+<td property="rdfs:comment">Other co-agents that participated in the action indirectly. E.g. John wrote a book with *Steve*.</td>
+</tr>
-<td property="rdfs:comment">People or tools that participated in performing the Action which are not the primary performer specified by performedBy.</td>
-</tr>
+
<tr typeof="rdf:Property" resource="http://schema.org/object">
-
<th property="rdfs:label">object</th>
-
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-</td>
-
-<td property="rdfs:comment">The main item directly affected by the Action. The precise meaning of the property is dependent on the Action sub-type. Sub-actions may introduced more specific object properties that are rdfs:subPropertyOf object.</td>
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/target">
-
-<th property="rdfs:label">target</th>
-
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-</td>
-
-<td property="rdfs:comment">The target item of the Action. The precise meaning of the property is dependent on the Action sub-type. Will often be the things whose relation to the action is described with the English propositions "to", "in", "with" or "for". Specific kinds of Action may introduce more specific target properties that are rdfs:subPropertyOf the 'target' property.
-</td>
-
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/result">
-
-<th property="rdfs:label">result</th>
-
<td>
<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
</td>
+<td property="rdfs:comment">The object upon the action is carried out, whose state is kept intact or changed. Also known as the semantic roles patient, affected or undergoer (which change their state) or theme (which doesnt).</td>
+</tr>
-<td property="rdfs:comment">Item that is the result of the performed Action.</td>
+
+<tr typeof="rdf:Property" resource="http://schema.org/result">
+<th property="rdfs:label">result</th>
+<td>
+<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
+<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
+</td>
+<td property="rdfs:comment">The result produced in the action. E.g. John wrote *a book*.</td>
</tr>
+
<tr typeof="rdf:Property" resource="http://schema.org/startTime">
-
<th property="rdfs:label">startTime</th>
-
<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<!-- todo: relationship to event ? -->
-
+<link property="http://schema.org/domain" href="http://schema.org/Action"></link> <!-- todo: relationship to event ? -->
<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
</td>
-
<td property="rdfs:comment">When the Action was performed: start time. This is for actions that span a period of time.</td>
-
</tr>
<tr typeof="rdf:Property" resource="http://schema.org/endTime">
-
<th property="rdfs:label">endTime</th>
-
<td>
<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
</td>
-
<td property="rdfs:comment">When the Action was performed: end time. This is for actions that span a period of time.</td>
-
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/createdTime">
-
-<th property="rdfs:label">createdTime</th>
-
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
-</td>
-
-<td property="rdfs:comment">When the Action information was created. It might be different from the action's start or end time if the action's information was reported at a different time.</td>
-
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/updatedTime">
-
-<th property="rdfs:label">updatedTime</th>
-
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
-</td>
-
-<td property="rdfs:comment">When the Action information was last updated.</td>
</tr>
<tr typeof="rdf:Property" resource="http://schema.org/location">
-
<th property="rdfs:label">location</th>
-
<td>
<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Place">Place</a>
+<a property="http://schema.org/range" href="http://schema.org/Place">Place</a>,
+<a property="http://schema.org/range" href="http://schema.org/PostalAddress">PostalAddress</a>
</td>
-
-<td property="rdfs:comment">The location of the event, action or organization.</td>
-
-</tr>
-
-
-<tr typeof="rdf:Property" resource="http://schema.org/creator">
-<th property="rdfs:label">creator</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/SoftwareApplication">SoftwareApplication</a> (note: creator already expects Organization or Person, from its CreativeWork definition. Here we change its definition to be more general)
-</td>
-<td property="rdfs:comment">The creator or author of this item.</td>
+<td property="rdfs:comment">The location of an event, action or organization.</td>
</tr>
</tbody></table>