linkedresearch / linkedresearch.org

:globe_with_meridians: linkedresearch.org
https://linkedresearch.org/
Creative Commons Zero v1.0 Universal
42 stars 18 forks source link

Specify data shape for annotation notifications #9

Open csarven opened 7 years ago

csarven commented 7 years ago

Annotations can be subdivided to Web Annotation motivations. Some relevant ones listed in ballpark priority that should be specified:

..

csarven commented 7 years ago

MUST include:

# No need to declare the URI of the notification.
<>
  a as:Announce ;
# A valid xsd:dateTime.
  as:updated "2017-09-05T21:11:58.611Z"^^xsd:dateTime ;
# CC0 license must be declared here.
  schema:license <https://creativecommons.org/publicdomain/zero/1.0/> ;
# URI of the annotation (assessing, eg. peer review) that's being announced
  as:object <http://example.org/annotation> ;
# URI of the target of the annotation.
  as:target <http://example.net/article#introduction> .

# An annotation with assessing motivation.
<http://example.org/annotation>
  a oa:Annotation ;
  oa:motivation oa:assessing .

SHOULD include:

# URI of the agent (but not the software) that sent the notification.
<>
  as:actor <http://csarven.ca/#i> .

# URI of an open/free culture license on the article is expected here.
<http://example.org/annotation>
  schema:license <https://creativecommons.org/licenses/by/4.0/> .

MAY include: Anything else that may help with the reuse of this notification or discovery of the resources it refers to. This does not mean that the body of the referred resources should be copied here.