Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Specify data shape for annotation notifications #9

Open
1 of 8 tasks
csarven opened this issue Aug 31, 2017 · 1 comment
Open
1 of 8 tasks

Specify data shape for annotation notifications #9

csarven opened this issue Aug 31, 2017 · 1 comment

Comments

@csarven
Copy link
Member

csarven commented Aug 31, 2017

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

  • assessing
  • replying
  • commenting
  • describing
  • linking
  • moderating
  • tagging
  • questioning

..

@csarven
Copy link
Member Author

csarven commented Sep 5, 2017

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant