Representing curatorial descriptions as annotations

[ptgolden]

Here's a draft:

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix dbpedia: <http://dbpedia.org/resource/> .
@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix dc: <http://purl.org/dc/elements/1.1/> .
@prefix oa: <http://www.w3.org/ns/oa#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix periodo: <http://n2t.net/ark:/99152/p0v#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix time: <http://www.w3.org/2006/time#> .
@prefix void: <http://rdfs.org/ns/void#> .
@prefix xml: <http://www.w3.org/XML/1998/namespace> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<http://n2t.net/ark:/99152/p0zmdxzf369>
    a skos:Concept ;
    periodo:spatialCoverageDescription "Ras Shamra" ;
    dc:language "en" ;
    dcterms:language <http://lexvo.org/id/iso639-1/en> ;
    skos:altLabel "Pre-pottery Neolithic"@en ;
    skos:inScheme <http://n2t.net/ark:/99152/p0zmdxz> ;
    skos:prefLabel "Pre-pottery Neolithic" ;
    time:intervalStartedBy [
        skos:prefLabel "Ca. 7500 B.C.E." ;
    ] ;
    time:intervalFinishedBy [
        skos:prefLabel "Ca. 7000 B.C.E." ;
    ] .

:periodannot
    a oa:Annotation ;
    oa:motivation oa:describing ;
    oa:hasTarget <http://n2t.net/ark:/99152/p0zmdxzf369> ;
    oa:hasBody [
        dcterms:spatial dbpedia:Ugarit ;
        time:intervalStartedBy [
            time:hasDateTimeDescription [
                time:year "-7499"^^xsd:gYear
            ]
        ] ;
        time:intervalFinishedBy [
            time:hasDateTimeDescription [
                time:year "-6999"^^xsd:gYear
            ]
        ]
    ] .

dbpedia:Ugarit
    skos:prefLabel "Ras Shamra" .

<http://n2t.net/ark:/99152/p0zmdxzf369.ttl>
    void:inDataset <http://n2t.net/ark:/99152/p0d> .

[ptgolden]

We might want to subclass oa:Annotation to differentiate between annotations that are expected to be added in the curatorial process (like spatial coverage, parsed dates, translated labels), and potentially arbitrary (?) ones that may be added by others.

Or maybe, just the distinction between oa:describing and oa:commenting is appropriate

[ptgolden]

We should do this before the UT deployment + client rewrite release, along with renaming Collection to Authority. I can make a patch for both soon.

[ptgolden]

In terms of how the updated JSON-LD would look...

{
  "@context": [
    "https://staging.perio.do/c",
    {
      "@base": "http://n2t.net/ark:/99152/",
      "oa": "http://www.w3.org/ns/oa#",
      "annotations": {
        "@reverse": "oa:hasTarget",
        "@container": "@set"
      },
      "body": {
        "@id": "oa:hasBody",
        "@type": "@id"
      },
      "motivation": {
        "@id": "oa:hasMotivation",
        "@type": "@id"
      }
    }
  ],
  "id": "p0zmdxzf369",
  "type": "PeriodDefinition",
  "spatialCoverageDescription": "Ras Shamra",
  "languageTag": "en",
  "language": "http://lexvo.org/id/iso639-1/en",
  "primaryTopicOf": {
    "inDataset": "p0d",
    "id": "p0zmdxzf369.json.html"
  },
  "collection": "p0zmdxz",
  "label": "Pre-pottery Neolithic",
  "start": {
    "label": "Ca. 7500 B.C.E."
  },
  "stop": {
    "label": "Ca. 7000 B.C.E."
  },
  "annotations": [
    {
      "id": "p0zmdxzf369-annotation",
      "type": "periodo:CuratorialAnnotation",
      "motivation": "oa:describing",
      "body": {
        "start": { "in": { "year": "-7499" }},
        "stop": { "in": { "year": "-6999" }},
        "spatialCoverage": [
          {
            "label": "Ras Shamra",
            "id": "http://dbpedia.org/resource/Ugarit"
          }
        ],
        "localizedLabels": {
          "en": [
            "Pre-pottery Neolithic"
          ]
        },
      }
    }
  ]
}

Does it make you puke?

[ptgolden]

I made it so that there could be multiple annotations, making room for the ability to allow arbitrary linked data to be attached to a period. But it would probably be better to use something like curated or description or ??? as a key to our curated stuff about the period. (i.e., the information we make a commitment to provide: a parsed date, localized labels, estimated spatial coverage).

Some drawbacks...

• It's more difficult to deal with programmatically (from parsed JSON). Getting the start date goes from period.start.in.year to period.annotations[0].start.in.year. Or, if we take my suggestion above, period.curated.start.in.year

• period.start.label and period.curated.start.in.year will refer to different blank nodes.

You could argue, however, that both of these changes make sense. There's an essential difference between the stuff we say is "from the text" and our interpretation of it. This makes that difference something that has to be understood and dealt with.

[ptgolden]

Another possibility, using the new JSON-LD 1.1 @nest keyword, which would further emphasize the difference between statements in the text and curatorial/annotated statements:

{
  "@context": [
    "https://staging.perio.do/c",
    {
      "@base": "http://n2t.net/ark:/99152/",
      "inTheText": "@nest",
      "oa": "http://www.w3.org/ns/oa#",
      "curated": {
        "@reverse": "oa:hasTarget",
        "@type": "periodo:CuratorialAnnotation"
      },
      "body": {
        "@id": "oa:hasBody",
        "@type": "@id"
      },
      "motivation": {
        "@id": "oa:hasMotivation",
        "@type": "@id"
      }
    }
  ],
  "id": "p0zmdxzf369",
  "type": "PeriodDefinition",
  "primaryTopicOf": {
    "inDataset": "p0d",
    "id": "p0zmdxzf369.json.html"
  },
  "collection": "p0zmdxz",
  "inTheText": {
    "spatialCoverageDescription": "Ras Shamra",
    "languageTag": "en",
    "language": "http://lexvo.org/id/iso639-1/en",
    "label": "Pre-pottery Neolithic",
    "start": {
      "label": "Ca. 7500 B.C.E."
    },
    "stop": {
      "label": "Ca. 7000 B.C.E."
    },
  },
  "curated": {
    "id": "p0zmdxzf369-annotation",
    "motivation": "oa:describing",
    "body": {
      "start": { "in": { "year": "-7499" }},
      "stop": { "in": { "year": "-6999" }},
      "spatialCoverage": [
        {
          "label": "Ras Shamra",
          "id": "http://dbpedia.org/resource/Ugarit"
        }
      ],
      "localizedLabels": {
        "en": [
          "Pre-pottery Neolithic"
        ]
      },
    }
  }
}