Link Search Menu Expand Document

TECHNICAL APPENDIX: how to linking this document

As stated above, the “LAGO Data and Metadata Releases, Rights and Disclaimer 1.1” document unifies the rights, disclaimers and acknolegmentes for the LAGO data and metadata 1.1 main release.

To accomplish the linked-data requirements, the aforementioned document has associated metatada in:

  • a JSON-LD file lagoCommonRights.1.1.jsonld
  • a block <script type="application/ld+json">, which shows the later JSON-LD in the <head> section of this HTML page.

There are several ways to perform linking, described in this technical appendix.

How should this document be referenced for linked-data?

To preserve the provenance of the linked metadata through time, the GitHub raw link of a certain tag release (Major.Minor.Patch) of this document must be used:

https://raw.githubusercontent.com/lagoproject/DMP/<Major.Minor.Patch>/rights/lagoCommonRights.1.1.jsonld

For example:

https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/rights/lagoCommonRights.1.1.jsonld

As a real example, the metadata´s catalog of a simulation should include the reference as the DCAT-AP2 property rights:

{
"@context":{
...
            "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/schema/lagoSchema.1.1.jsonld",
            "@vocab":"https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld",
...
          },
"@id":"/sac_60_100.0_75600_QGSII_flat",
"@type":"Catalogue",
...
"license":"https://creativecommons.org/licenses/by-nc-sa/4.0/"
"rights":"https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/rights/lagoCommonRights.1.1.jsonld",
"accessRigths":"http://publications.europa.eu/resource/authority/access-right/RESTRICTED",
"creator":{
           "@id":"https://orcid.org/0000-0001-6497-753X",
           "@type":"lago:Person"
          },
...
...

How could this document be embarranssingly referenced?

Although it is discouraged because these methods do not preserve the metadata provenance, it could be sometimes needed linking this document using only the main release (the Major.Minor) as reference and forgetting the GitHub tag release.

As this document has Major.Minor = 1.1 version, there are alternative ways:

The plain JSON-LD file

{
  "@context" : {
    "@base" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1.0", 
    "lago" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/schema/lagoSchema.1.1.jsonld#",
    "dct" : "http://purl.org/dc/terms/",
    "@vocab" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#",
    "_dcatap" : "https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld",
    "_dcatap_landing_page" : "http://data.europa.eu/r5r/"
  },
"@id" : "/rights/lagoCommonRights.1.1.jsonld",
"title": "Data and Metadata Release, Rights and Disclaimer",
"creator" : [{ "@id" : "https://orcid.org/0000-0002-4559-8785" , "@type" : "lago:Person", "name" : "Hernán Asorey" },
             { "@id" : "https://orcid.org/0000-0003-4115-3129" , "@type" : "lago:Person", "name" : "Iván Sidelnik" }],
"releaseDate" : "2022-05-10",
"conformsTo" : { "@id" : "https://github.github.com/gfm/" , "@type" : "Document", "title": "GitHub Flavored Markdown Spec", "preferredLabel" :"GFM"},
"relatedResource" : "https://lagoproject.net/lagoCommonRights/1.1.html",
"isVersionOf": [ "https://doi.org/10.5281/zenodo.6599863", "https://zenodo.org/record/6599863", "https://lagoproject.net/lagoCommonRights/1.1" ],
"publisher" :  { "@id" : "/defs/lagoCollaboration.1.1.jsonld" , "@type" : "lago:Organization", "name" : "LAGO Collaboration" },
"license" : "https://creativecommons.org/licenses/by-nc-sa/4.0/",
"accessRigths" : "@id",
"descprition" : "By using the data provided by the Latin American Giant Observatory (LAGO), you are accepting the following conditions of release and acknowledging the following disclaimers issued by LAGO.",
"@type" : "Document",
"landingPage" : "https://lagoproject.github.io/DMP/rights/lagoCommonRights.1.1/",
"version" : "1.1",
"distribution": { "@id": "/rights/lagoCommonRights.1.1.md", 
                  "@type": "Distribution",
                  "accessURL": "https://lagoproject.github.io/DMP/rights/lagoCommonRights.1.1/",
                  "downloadURL": "/rights/lagoCommonRights.1.1.md", 
                  "format": "http://publications.europa.eu/resource/authority/file-type/TXT",  
                  "mediaType": "https://www.iana.org/assignments/media-types/text/markdown"
                }
}