Hypothes.is


Agent Source token	`8075957f-e0da-405f-9eee-7f35519d7c4c`
Consumes Artifacts	`domain-list`
Subject coverage	All Hypothes.is annotations that are available to the public
Object coverage	All DOIs, Landing Page URLs, plain text DOIs.
Data contributor	Hypothes.is
Data origin	Annotations made by Hypothes.is users, via the Hypothes.is API
Freshness	Every few hours.
Identifies	Linked DOIs, unlinked DOIs, Landing Page URLs
License	Creative commons CC0 1.0 Universal (CC0 1.0)
Looks in	URL for annotation, text of annotations
Name	Hypothes.is
Operated by	Crossref
Produces Evidence Records	Yes
Produces relation types	`annotates`, `discusses`
Source ID	`hypothesis`
Updates or deletions	None expected

What it is

Users of the Hypothes.is annotate and discuss webpages. The Hypothes.is Agent monitors annotations. It looks for two things: the annotation of registered content (for example Article Landing Pages) and the mentioning of registered content (for example DOIs) in the text of annotations.

What it does

When looking for annotations of registered content:

Scans every Article Landing Page domain in the domain-list, including doi.org.
Makes a query to the Hypothes.is API for annotations to URLs on that domain.
For each result, attempts to reverse that URL back to a registered content item, recording an Event with the annotates relation type.
Scans every Article Landing Page domain in the domain-list, including doi.org.
Makes a query to the Hypothes.is API for annotations that contain URLs on that domain in the text of the annotation.
For each result, looks in the text for links to registered content and records Events with the discusses relation type.

Example Event

Annotates:

{
  "license": "https://creativecommons.org/publicdomain/zero/1.0/",
  "obj_id": "https://doi.org/10.1007/bfb0105342",
  "source_token": "8075957f-e0da-405f-9eee-7f35519d7c4c",
  "occurred_at": "2015-11-04T06:30:10Z",
  "subj_id": "https://hypothes.is/a/NrIw4KlKTwa7MzbTrMAyjw",
  "id": "00044ac9-d729-4d3f-a2c8-618bcdf1d252",
  "evidence_record": "https://0-evidence-eventdata-crossref-org.library.alliant.edu/evidence/20170412-hypothesis-de560308-e500-4c55-ba28-799d7b272039",
  "terms": "https://doi.org/10.13003/CED-terms-of-use",
  "action": "add",
  "subj": {
    "pid": "https://hypothes.is/a/NrIw4KlKTwa7MzbTrMAyjw",
    "json-url": "https://hypothes.is/api/annotations/NrIw4KlKTwa7MzbTrMAyjw",
    "url": "https://hyp.is/NrIw4KlKTwa7MzbTrMAyjw/arxiv.org/abs/quant-ph/9803052",
    "type": "annotation",
    "title": "[This article](http://arxiv.org/abs/quant-ph/9803052) was referenced by [\"Decoherence\"](http://web.mit.edu/redingtn/www/netadv/Xdecoherenc.html) on Sunday, September 25 2005.",
    "issued": "2015-11-04T06:30:10Z"
  },
  "source_id": "hypothesis",
  "obj": {
    "pid": "https://doi.org/10.1007/bfb0105342",
    "url": "http://arxiv.org/abs/quant-ph/9803052"
  },
  "timestamp": "2017-04-12T07:16:20Z",
  "relation_type_id": "annotates"
}

Discusses:

  {
    "license": "https://creativecommons.org/publicdomain/zero/1.0/",
    "obj_id": "https://doi.org/10.1146/annurev.earth.32.082503.144359",
    "source_token": "8075957f-e0da-405f-9eee-7f35519d7c4c",
    "occurred_at": "2015-05-11T04:03:44Z",
    "subj_id": "https://hypothes.is/a/qNv_Ei5ZSnWOWO54GXdFPA",
    "id": "00054d54-7f35-4557-b083-7fa1f028856d",
    "evidence_record": "https://0-evidence-eventdata-crossref-org.library.alliant.edu/evidence/20170413-hypothesis-a37bc9bf-1dc0-4c8a-b943-2e14beb4de6f",
    "terms": "https://doi.org/10.13003/CED-terms-of-use",
    "action": "add",
    "subj": {
      "pid": "https://hypothes.is/a/qNv_Ei5ZSnWOWO54GXdFPA",
      "json-url": "https://hypothes.is/api/annotations/qNv_Ei5ZSnWOWO54GXdFPA",
      "url": "https://hyp.is/qNv_Ei5ZSnWOWO54GXdFPA/www.cnn.com/2015/05/05/opinions/sutter-sea-level-climate/#",
      "type": "annotation",
      "title": "The various scenarios presented should be specified as being global averages of expected sea level rise. The sea level rise observed locally will vary significantly, due to a lot of different geophysical factors.",
      "issued": "2015-05-11T04:03:44Z"
    },
    "source_id": "hypothesis",
    "obj": {
    "pid": "https://doi.org/10.1146/annurev.earth.32.082503.144359",
    "url": "https://doi.org/10.1146/annurev.earth.32.082503.144359"
    },
    "timestamp": "2017-04-13T10:40:18Z",
    "relation_type_id": "discusses"
  }

Evidence Record

Creates observations of type landing-page-url for annotates relation types.
Creates observations of type plaintext for discusses relation types.

Edits / deletion

Events may be edited if they are found to be faulty, e.g. non-existent DOIs.

Quirks

None known.

Failure modes

We may fail to reverse landing pages to DOIs.
The Hypothesis API may be unavailable.

Further information

Hypothes.is