Open Annotation Data Model: AppendicesCommunity Draft, 08 February 2013 |
Open Annotation Data Model: AppendicesCommunity Draft, 08 February 2013 |
The OA Community Group's February 2013 Open Annotation Data Model (this document) has been superseded the following W3C Web Annotation Working Group Candiate Recommendations (July 2016):
Implementers are encouraged to begin using the newer specifications as soon as practicable.The Open Annotation data model specifies a very simple method of expressing the provenance of an Annotation. This is able to be mapped into the richer and more complex W3C PROV model.
The PROV model is expressed in terms of Activities and Entities consumed or produced by those Activities.
There are two Entities in the Open Annotation model, which for expediency and simplicity are collapsed into just oa:Annotation.
These are the Annotation document, and the concept that the Annotation embodies or describes.
This is the distinction between oa:annotatedBy and oa:annotatedAt,
versus oa:serializedBy and oa:serializedAt. In the PROV model we have to split these apart again.
We use the oa:Annotation for the concept, and thus still require an Annotation document.
There are also two Activities, Annotating and Serializing, which produce these Entities. In this case, Annotating is the process of annotating a resource, and should not be confused or conflated with the Motivation of the same name. Serializing is the process by which the Annotation Document is created.
The Annotation document is derived from the concept, which necessarily comes first.
The concept was produced as the outcome of the Annotating process, which was performed by an Agent,
the object of oa:annotatedBy. The Annotation document was produced as the outcome of the Serializing process,
which was also performed by an Agent, the object of oa:serializedBy. Both of these processes happened at a
particular point in time, oa:annotatedAt and oa:serializedAt, respectively.
<anno1> a oa:Annotation ;
a prov:Entity ;
prov:wasGeneratedBy <serializing1> ;
prov:wasDerivedFrom <annoConcept1> ;
prov:generatedAt "datetime1" ;
oa:serializedAt "datetime2" ;
oa:serializedBy <agent2> ;
oa:annotatedBy <agent1>
oa:annotatedAt "datetime1" ;
<annotating1> a prov:Activity ;
prov:wasAssociatedWith <agent1> .
<annoDocument1> a prov:Entity ;
prov:generatedAt "datetime2" ;
prov:wasGeneratedBy <serializing1> .
<serializing1> a prov:Activity ;
prov:wasAssociatedWith <agent2> .
Although the list of Motivations in the specification is derived from an extensive survey of the annotation landscape, there are many situations where more exact definitions of Motivation are required or desirable. In these cases it is RECOMMENDED to create a new Motivation resource and relate it to one or more that already exist.
New Motivations MUST be instances of oa:Motivation, which is a subClass of skos:Concept.
The skos:broader relationship SHOULD be asserted between the new Motivation and at least one existing Motivation, if there are any that are broader in scope. Other relationships, such as skos:relatedMatch, skos:exactMatch and skos:closeMatch, SHOULD also be asserted to concepts created by other communities.
oa:motivationScheme a skos:ConceptScheme ;
oa:editing a oa:Motivation ;
skos:inScheme oa:motivationScheme ;
skos:prefLabel "Editing"@en .
new:correcting a oa:Motivation ;
skos:inScheme new:aScheme ;
skos:broader oa:editing ;
skos:prefLabel "Correcting a Mistake"@en .
new2:fixing a oa:Motivation ;
skos:inScheme new2:anotherScheme ;
skos:broader oa:editing ;
skos:closeMatch new:correcting ;
skos:prefLabel "Fixing a Mistake"@en .
This specification builds upon the work from many previous annotation efforts, including in particular:
The editors would like to acknowledge the financial support of the Andrew W. Mellon Foundation for the Open Annotation Collaboration and funding the initial reconcilliation between the Annotation Ontology and Open Annotation Collaboration models.
| Date | Editor | Description |
|---|---|---|
| 2013-02-08 | rsanderson | Namespace change for W3C best practice |
| 2013-02-05 | rsanderson | W3C Community Draft 2 |
| 2013-01-28 | rsanderson | W3C Community Draft 2 (internal for final review) |
| 2013-01-07 | rsanderson | W3C Community Draft 2 (internal for review) |
| 2012-05-09 | rsanderson | License Correction |
| 2012-05-01 | rsanderson | W3C Community Draft |
| 2012-04-05 | rsanderson | Internal Draft 2 |
| 2012-03-30 | rsanderson | Internal Draft 1 |