Consolidating First DMP 1.1(.0) release (#14)

* adding some @defaults to schema

* test of CommonRights

* again

* ....

* .....

* ..

* ....

* .....

* .....

* .......

* ....

* ....

* ....

* .....

* .....

* ....

* ....

* ....

* ....

* Update lagoCommonRights.md

* Update lagoCommonRights.md

* Update lagoCommonRights.jsonld

* Update lagoCommonRights.md

* Update lagoCommonRights.jsonld

* Update lagoCommonRights.jsonld

* Test Versioning/Changelog

* .....

* Undo Test

* Adding clear versioning to DMP (#13)

* Naming files with release number

* Internal changes adding 1.1 release number

* more changes to include release number

* changing folders

* adding logo

Co-authored-by: AJRubio-Montero <AJRubio-Montero@github.com>

Co-authored-by: AJRubio-Montero <AJRubio-Montero@github.com>

AUTHORS

+# Original Author
+
+  2020. A.J. Rubio-Montero (http://orcid.org/0000-0001-6497-753X)
+
+# Developer Team:
+
+  2021-today: H. Asorey (https://github.com/asoreyh,   https://orcid.org/0000-0002-4559-8785)
+  2020-today: A.J. Rubio-Montero (https://github.com/AJRubio-Montero, http://orcid.org/0000-0001-6497-753X)
+   
+# Former Staff Members:
+
+  2021. Pagán Muñoz (https://github.com/rpaganmunoz, https://orcid.org/0000-0002-6802-8179)
+
+# Relevant Contributors: 
+
+  2022-today: I. Sidelnik (https://orcid.org/0000-0003-4115-3129)
+  2020-today: R. Mayo-García (https://orcid.org/0000-0002-0151-3954)  

DMP.md → DMP/DMP.1.1.md

 ---
 layout: default
-#title: Definitions
-has_children: false
-nav_order: 2
+parent: DMP document
+nav_order: 1
 ---
 
-# The LAGO Data Management Plan (DMP) document
+# The LAGO Data Management Plan (DMP) document 1.1
 {: .no_toc }
 
 |Version| Updated | Date |Contributors|
 |-------|---------|------|------------|
-| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration |
+| 1.1   | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration |
 
 
 ## Table of contents

DMP/DMP.md

+---
+layout: default
+title: DMP document
+has_children: true
+permalink: /DMP/
+nav_order: 2
+---
+
+# Released DMP in LAGO Collaboration

DMP/devDMPs.md

+---
+layout: default
+title: Dev DMPs
+parent: DMP document
+has_children: true
+nav_order: 8
+---
+
+# DMPs in developing phase
+

DMP/oldDMPs.md

+---
+layout: default
+title: Old DMPs
+parent: DMP document
+has_children: true
+nav_order: 9
+---
+
+# Older DMPs
+
+This section compiles outdated documents depicting the LAGO DMP. The objective is to maintain the linking among metadata with public URIs through the time.

README.md

@@ -11,12 +11,54 @@ This repository contains the Data Management Plan (DMP) for [Latin American Gian
 
 [https://lagoproject.github.io/DMP/](https://lagoproject.github.io/DMP/)
 
+## Release policy & preserving linking
+
+### Tagging policy & the main release
+
+The common numbering used for software versioning (`Major.Minor.Patch`) are also used in this repository:
+- Major release: identifies deep changes in definitions. As usual, migrating between major releases (i.e. *1.y.z -> 2.y.z*) will not provide backward compatibility.
+- Minor release: identifies improvements in definitions. Upgrading through minor releases (i.e. *x.1.z -> x.2.z*) implies compatibility.
+- Patch release: indicates admendements and corrections but without relevant changes.
+
+However, in order to simplify and reduce the number of files in the repository:
+- The filename of the linkable documents & definitions will contain only the `Major.Minor` number, just before their extension.
+- GitHub Tagging will also contain the patching, being the `Major.Minor.Patch`. 
+
+Thus, the `Major.Minor` is considered the **main release** or **version** on wich the development orbit around and the reference identifier of every version. Meanwhile, the `Major.Minor.Patch` is the **tag release** used in GitHub for consolidating patches. 
+
+### Repository organization 
+
+This [repository](https://github.com/lagoproject/DMP/) follows a fixed directory structure to preserve linking to definitions through the time:
+- `*DMP/*`: contains all the formal DMP documents improved and extended; 
+- `*schema/*`: all releases of the schema for LAGO data and metadata;
+- `*defs/*`: the different referenciable definitions of LAGO items (sites, institutions, harware,...) for a certain LAGO schema;
+- `*rights/*`: disclaimers and specific rights on the date when certain LAGO datasets are published;
+- `*notes/*`: release notes of every main release.
+
+The linkable documents in these folders are distinguised with their `Major.Minor` release number (i.e. their main release number). Therefore:
+- The web page will always show the last updated definitions for a `Major.Minor` release, for example: [https://lagoproject.github.io/DMP/schema/lagoSchema.1.1/](https://lagoproject.github.io/DMP/schema/lagoSchema.1.1/)
+- The [*master* branch](https://github.com/lagoproject/DMP/) will show the confirmed updates and the history of the patches.
+- Metadadata can link documents fixed in a `Major.Minor.Patch` release: [https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/rights/lagoCommonRights.1.1.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.1/rights/lagoCommonRights.1.1.jsonld)
+
+### Current release & visualisation
+
+The **current release** (`Major.Minor`) will be stated at first web page at [https://lagoproject.github.io/DMP/](https://lagoproject.github.io/DMP/), likewise the definitions for this current release will be shown in the default root of every aforementioned directories. 
+
+Independently of how the links preserved and documents stored, [https://lagoproject.github.io/DMP/](https://lagoproject.github.io/DMP/) will enable additional shortcuts and classifications. The most important are the virtual folders in the aforementioned fixed structure, which clasifies in developing versions (*Dev*) or outdated versions (*Old*).
+
+
 ## Contributing
 
+The procedure depends on the role of the contributor:
 - All LAGO members can contribute to the *dev* branch of DMP through pull requests.
 - Members of standardisation group can authorise pull requests to the *dev* branch, but not `merge` their own modifications to the *master* branch without an additional authorisation.
 - Only managers or administrators of the repository can directly `merge` the contribution to the *master* branch and publish stable releases.
 
+Restrictions:
+- Changing the current release is only allowed for managers.
+- `Minor` changes in *Old* definitions are strictly forbidden.
+
+
 ## License
 
 All contents of this repository are under the terms of the Creative Common [CC BY-NC-SA 4.0](./LICENSE) license, with exception of some code needed for rendering the web page, which has its own license declared at the head of the code.  

_config.yml

 # Minimun config
 title: "LAGO Data Management Plan"
-remote_theme: pmarsceill/just-the-docs
+# remote_theme: pmarsceill/just-the-docs
+# ajrm: make the theme static for LAGO
+remote_theme: lagoproject/just-the-docs-static
 # Color scheme supports "light" (default) and "dark"
 color_scheme: "light"
-# logo: "/images/lago.png"
+logo: "/assets/images/lago-logo-90-dmp.png"
+# logo: "https://lagoproject.net/images/lago-logo-90.png"
 # baseurl: "/DMP" # the subpath of your site, e.g. /blog
 # url: "https://lagoproject.github.io/DMP" # the base hostname & protocol for your site, e.g. http://example.com
 permalink: pretty

_includes/generate_html_for_vocab.1.0.html

+<!-- 
+################################################################################
+# Original Author: A.J. Rubio-Montero (http://orcid.org/0000-0001-6497-753X),  #
+#          CIEMAT - Sci-Track Group (http://rdgroups.ciemat.es/web/sci-track), #
+#          for the EOSC-Synergy project (EU H2020 RI Grant No 857647).         #
+# License (SPDX): BSD-3-Clause (https://opensource.org/licenses/BSD-3-Clause)  #
+# Copyright (c): 2020-today, The LAGO Collaboration (http://lagoproject.net)   #
+################################################################################
+-->
+<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script>
+<script>
+function itemnize_json( json, context, link ) { 
+  var html ='';
+  if ( (link == false) || (typeof(json) === 'boolean') )  return json;
+  if ( typeof(json) === 'string' ) {
+    var element = json.split(':');
+    var innid = element[0];
+    var vocab = "@vocab";
+    if (element.length == 2) {
+      if ( (element[0] !== "http") && (element[0] !== "https") ) {
+        innid = element[1];
+        vocab = element[0];
+      } else return json;
+    };
+    var contexturl = context[vocab];
+    if ( vocab == "lago" ) contexturl = '';  
+    if ( contexturl[contexturl.length-1] !== '#' )  contexturl = contexturl + '#';
+    if ( vocab == "sdo" ) contexturl = context[vocab];
+    else innid = json;
+    html = '<a href="'+ contexturl + innid +'">'+ json +'</a>';
+  } else {
+    if ( !(Array.isArray(json)) ) {
+      var json_aux = [];
+      json_aux.push(json);
+      json = json_aux;
+    };
+    for (var j=0; j<json.length; j++) {
+      var inner_json = json[j];
+      if ( !(typeof(json[j]) === 'string') ) {
+      	if ("@id" in json[j]) {
+          inner_json = json[j]["@id"];
+        } else {
+          inner_json = JSON.stringify(json[j]);
+	  link = false;
+        };
+      };
+      html = html + '<br />' + itemnize_json(inner_json, context, link);
+    };
+  };
+  return html;
+};
+$().ready(function(){
+  $.getJSON( "{{ include.folder }}", function( data ) { 
+    var graphelements = data["@graph"];
+    for (var i=0; i<graphelements.length; i++) {
+        if ("@id" in graphelements[i]) { 
+          var id = graphelements[i]["@id"];
+          var indexhtml = '<li><a href="#'+id+'">'+id+'</a></li>';
+          var headerhtml = '<h5 id="'+id+'"><a href="#'+id+'" class="anchor-heading" aria-labelledby="'+id+'"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a><strong>'+id+'</strong></h5>';
+          if ("comment" in graphelements[i]) {
+            headerhtml = headerhtml + '<p><small>'+ graphelements[i]["comment"][0]["@value"]+'</small></p>';
+          };
+          var keys = Object.keys(graphelements[i]);
+          keys.splice(keys.indexOf("@id"),1);
+          keys.splice(keys.indexOf("@type"),1);
+          keys.splice(keys.indexOf("comment"),1);
+          var table = '<table class="grid" style="width: 100%"> 
+		      <thead>
+			    <tr class="header">
+				<th>@type</th>';	  
+	  for (var k=0; k<keys.length; k++) {
+	    table = table + ' <th>'+ keys[k] + '</th>';
+	  };
+	  table = table +'	</tr>
+			</thead>
+			<tbody>
+			    <tr>
+			      <td>'+ itemnize_json(graphelements[i]["@type"] , data["@context"], true ) +'</td>';
+          for (var k=0; k<keys.length; k++) {
+            table = table + ' <td>'+ itemnize_json(graphelements[i][keys[k]] , data["@context"], true ) +'</td>';
+          };
+          table = table +'	</tr>
+			</tbody>
+		    </table>';
+          if ("dcat:domain" in graphelements[i]) {
+                  $('#iproperties').append(indexhtml);
+            $('#properties').append(headerhtml);
+                  $('#properties').append(table);				  
+          } else {
+            $('#iclasses').append(indexhtml);
+            $('#classes').append(headerhtml);
+            $('#classes').append(table);
+	  };
+	};
+      };		
+    });
+});
+</script>
+
+{% if include.vocabulary == "true" %}
+
+- [**Classes**](#classes)
+  <ul id="iclasses"></ul>
+		
+- [**Properties**](#properties)
+  <ul id="iproperties"></ul>
+
+### Classes
+
+<div id="classes"></div>
+
+### Properties
+
+<div  id="properties"></div>
+
+{% else %}
+
+- [**Items**](#items)
+  <ul id="iclasses"></ul>
+
+### Items
+
+<div id="classes"></div>
+
+{% endif %}
+

_includes/generate_html_for_vocab.html

@@ -85,9 +85,9 @@ $().ready(function(){
 			</tbody>
 		    </table>';
           if ("dcat:domain" in graphelements[i]) {
-                  $('#iproperties').append(indexhtml);
+            $('#iproperties').append(indexhtml);
             $('#properties').append(headerhtml);
-                  $('#properties').append(table);				  
+            $('#properties').append(table);				  
           } else {
             $('#iclasses').append(indexhtml);
             $('#classes').append(headerhtml);
@@ -113,7 +113,7 @@ $().ready(function(){
 
 ### Properties
 
-<div  id="properties"></div>
+<div id="properties"></div>
 
 {% else %}
 

_includes/head_custom.html

+{% if page.jsonldinhead %}
+    <script type="application/ld+json">
+    {% include_relative {{page.jsonldinhead}} %}
+    </script>
+{% endif %}
\ No newline at end of file

defs/index.md → defs/defs.md

@@ -8,4 +8,4 @@ nav_order: 4
 
 # Established definitions
 
-This section fixes the definition of certain LAGO actors following the [metadata schema](/schema/lagoSchema). The objective is to allow linking metadata with public URIs.
+This section fixes the definition of certain LAGO actors following the [metadata schemas](/schema/). The objective is to allow linking metadata with public URIs.

defs/devdefs.md

+---
+layout: default
+title: Dev Defs
+parent: Definitions
+has_children: true
+nav_order: 8
+---
+
+# Definitions in developing phase
+

defs/lagoCollaboration.1.1.jsonld

+{
+  "@context" : { 
+    "@vocab" : "http://schema.org/",
+    "lago" : "https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/schema/lagoSchema.1.1.jsonld#",
+    "foaf" : "http://xmlns.com/foaf/0.1/",
+    "org" : "https://www.w3.org/TR/vocab-org/#", 
+    "owl" : "http://www.w3.org/2002/07/owl#",   
+  },
+    "@id" : "https://lagoproject.net/", 
+    "@type" : "Organization",
+    "owl:equivalentClass" : [ "lago:Organization", "foaf:Organization", "org:OrganizationalCollaboration"],
+    "name" : "LAGO Collaboration",
+    "description" : "The LAGO Collaboration is a non-centralized, distributed and highly collaborative grid of scientific institutions. The main goal of the LAGO Collaboration is the design, installation, commissioning, operation, coordination, maintenance, and, eventually, the decommissioning of the Latin American Giant Observatory (LAGO). LAGO is an astroparticle observatory on a global scale, working as an integrated detection network, hereinafter referred to as 'the LAGO detection network' or simply 'the LAGO network', of single or small arrays of detectors, hereinafter referred to as 'the LAGO detectors', that are deployed at different geographical locations, hereinafter referred as “the LAGO sites”.",
+    "url" : "https://lagoproject.net/",
+    "sameAs" : [ "https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.1/",
+                 "https://lagoproject.net/collab.html",
+                 "https://doi.org/10.48550/arXiv.1909.10039",
+                 "https://github.com/lagoproject/",
+                 "https://hub.docker.com/u/lagocollaboration" ],
+    "logo" : "https://lagoproject.net/images/lago-logo-90.png"
+}

defs/lagoCollaboration.md → defs/lagoCollaboration.1.1.md

@@ -4,12 +4,12 @@ parent: Definitions
 nav_order: 2
 ---
 
-# LAGO Collaboration 
+# LAGO Collaboration 1.1
 {: .no_toc }
 
 |Version| Updated | Date |Contributors|
 |-------|---------|------|------------|
-| 1.1 develop | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration |
+| 1.1   | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration |
 
 
 ## Table of contents
@@ -20,19 +20,20 @@ nav_order: 2
 
 ## What is defined?
 
-[lagoCollaboration.jsonld](./lagoCollaboration.jsonld) unifies the definition of the LAGO Collaboration following the official LAGO schema vocabulary. 
+[lagoCollaboaration.1.1.jsonld](./lagoCollaboaration.1.1.jsonld) unifies the definition of the LAGO Collaboration following the official LAGO schema vocabulary. 
 
 The purpose of the definition is to univocally identify the LAGO Collaboration employing a public URI for being linked by any metadata. 
 
-## How should an item be referenced?
 
-To preserve the provenance of the linked metadata through time, the GitHub raw link of a certain release of this document must be used:
+## How should this definition be referenced for linked-data?
 
-`https://raw.githubusercontent.com/lagoproject/DMP/`*\<tag release\>*`/defs/lagoCollaboration.jsonld`
+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\>*`/defs/lagoCollaboaration.1.1.jsonld`
 
 For example:
 
-[https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld)
+[https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/defs/lagoCollaboaration.1.1.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/defs/lagoCollaboaration.1.1.jsonld)
 
 
 As a real example, the metadata´s catalog of a simulation should include the reference to the [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) property [publisher](https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#publisher):
@@ -41,7 +42,7 @@ As a real example, the metadata´s catalog of a simulation should include the re
 {
 "@context":{
 ...
-            "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/schema/lagoSchema.jsonld",
+            "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",
 ...
           },
@@ -50,16 +51,35 @@ As a real example, the metadata´s catalog of a simulation should include the re
 "title":"sac_60_100.0_75600_QGSII_flat",
 "description":"A Complete Corsika Simulation",
 "publisher":{
-             "@id":"https://raw.githubusercontent.com/lagoproject/DMP/1.1/defs/lagoCollaboration.jsonld",
+             "@id":"https://raw.githubusercontent.com/lagoproject/DMP/1.1.0/defs/lagoCollaboaration.1.1.jsonld",
              "@type":"lago:Organization"
             },
 ...
 ...
 ```
 
+### How could this definition be embarranssingly referenced?
+
+Although it is **discouraged** because these methods do not preserve the metadata provenance,  it could be sometimes needed referencing using alternative ways.
+
+- Links to other official LAGO pages: gererally are updated but not corresponding with the the release of software used for generating the metadata.
+  - Directly, the main page for LAGO Collaboration [http://lagoproject.net](http://lagoproject.net) page.
+  - The current list of collaborators: [https://lagoproject.net/collab.html](https://lagoproject.net/collab.html)
+  - CURL command against *lagoproject.net* page: (TBD.)
+  - The GitHub repository for LAGO Collaboration: [https://github.com/lagoproject/](https://github.com/lagoproject/),
+  - The DockerHub repositroy for LAGO Collaboration: [https://hub.docker.com/u/lagocollaboration](https://hub.docker.com/u/lagocollaboration)
+  
+- Alternative static documents: they could be outdated with respect to the release of software used for generating the metadata.
+  - arXiv DOI: [https://doi.org/10.48550/arXiv.1909.10039](https://doi.org/10.48550/arXiv.1909.10039)  
+  
+- Linking this document using only the **main release** (the ``Major.Minor``) as reference and forgetting the GitHub tag release, altough it could include changes which were not taken into account when the metadata was generated. As this document has ``Major.Minor = 1.1`` version
+  - GitHub dynamic page for the : [https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.1/](https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.1/)
+  - CURL command against this GitHub dynamic page (TBD).
+
+
 ## Plain JSON-LD file
 
 ```json
-{% include_relative lagoCollaboration.jsonld %}
+{% include_relative lagoCollaboration.1.1.jsonld %}
 ```
 

defs/lagoCollaboration.1.2.jsonld

+{
+  "@context" : { 
+    "@vocab" : "http://schema.org/",
+    "lago" : "https://raw.githubusercontent.com/lagoproject/DMP/1.2.0/schema/lagoSchema.1.2.jsonld#",
+    "foaf" : "http://xmlns.com/foaf/0.1/",
+    "org" : "https://www.w3.org/TR/vocab-org/#", 
+    "owl" : "http://www.w3.org/2002/07/owl#",   
+  },
+    "@id" : "https://lagoproject.net/", 
+    "@type" : "Organization",
+    "owl:equivalentClass" : [ "lago:Organization", "foaf:Organization", "org:OrganizationalCollaboration"],
+    "name" : "LAGO Collaboration",
+    "description" : "The LAGO Collaboration is a non-centralized, distributed and highly collaborative grid of scientific institutions. The main goal of the LAGO Collaboration is the design, installation, commissioning, operation, coordination, maintenance, and, eventually, the decommissioning of the Latin American Giant Observatory (LAGO). LAGO is an astroparticle observatory on a global scale, working as an integrated detection network, hereinafter referred to as 'the LAGO detection network' or simply 'the LAGO network', of single or small arrays of detectors, hereinafter referred to as 'the LAGO detectors', that are deployed at different geographical locations, hereinafter referred as “the LAGO sites”.",
+    "url" : "https://lagoproject.net/",
+    "sameAs" : [ "https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.2/",
+                 "https://lagoproject.net/collab.html",
+                 "https://doi.org/10.48550/arXiv.1909.10039",
+                 "https://github.com/lagoproject/",
+                 "https://hub.docker.com/u/lagocollaboration" ],
+    "logo" : "https://lagoproject.net/images/lago-logo-90.png"
+}

defs/lagoCollaboration.1.2.md

+---
+layout: default
+parent: Dev Defs
+grand_parent: Definitions
+---
+
+# LAGO Collaboration 1.2
+{: .no_toc }
+
+|Version| Updated | Date |Contributors|
+|-------|---------|------|------------|
+| 1.2   | {{ site.time }} | 2020-06-01 - today | LAGO Collaboration |
+
+
+## Table of contents
+{: .no_toc .text-delta }
+
+- TOC
+{:toc}
+
+## What is defined?
+
+[lagoCollaboaration.1.2.jsonld](./lagoCollaboaration.1.2.jsonld) unifies the definition of the LAGO Collaboration following the official LAGO schema vocabulary. 
+
+The purpose of the definition is to univocally identify the LAGO Collaboration employing a public URI for being linked by any metadata. 
+
+
+## How should this definition 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\>*`/defs/lagoCollaboaration.1.2.jsonld`
+
+For example:
+
+[https://raw.githubusercontent.com/lagoproject/DMP/1.2.0/defs/lagoCollaboaration.1.2.jsonld](https://raw.githubusercontent.com/lagoproject/DMP/1.2.0/defs/lagoCollaboaration.1.2.jsonld)
+
+
+As a real example, the metadata´s catalog of a simulation should include the reference to the [DCAT-AP2](https://joinup.ec.europa.eu/collection/semantic-interoperability-community-semic/solution/dcat-application-profile-data-portals-europe) property [publisher](https://raw.githubusercontent.com/SEMICeu/DCAT-AP/2.0.0/releases/2.0.0/dcat-ap_2.0.0.jsonld#publisher):
+
+```json
+{
+"@context":{
+...
+            "lago":"https://raw.githubusercontent.com/lagoproject/DMP/1.2.0/schema/lagoSchema.1.2.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":"Catalog",
+"title":"sac_60_100.0_75600_QGSII_flat",
+"description":"A Complete Corsika Simulation",
+"publisher":{
+             "@id":"https://raw.githubusercontent.com/lagoproject/DMP/1.2.0/defs/lagoCollaboaration.1.2.jsonld",
+             "@type":"lago:Organization"
+            },
+...
+...
+```
+
+### How could this definition be embarranssingly referenced?
+
+Although it is **discouraged** because these methods do not preserve the metadata provenance,  it could be sometimes needed referencing using alternative ways.
+
+- Links to other official LAGO pages: gererally are updated but not corresponding with the the release of software used for generating the metadata.
+  - Directly, the main page for LAGO Collaboration [http://lagoproject.net](http://lagoproject.net) page.
+  - The current list of collaborators: [https://lagoproject.net/collab.html](https://lagoproject.net/collab.html)
+  - CURL command against *lagoproject.net* page: (TBD.)
+  - The GitHub repository for LAGO Collaboration: [https://github.com/lagoproject/](https://github.com/lagoproject/),
+  - The DockerHub repositroy for LAGO Collaboration: [https://hub.docker.com/u/lagocollaboration](https://hub.docker.com/u/lagocollaboration)
+  
+- Alternative static documents: they could be outdated with respect to the release of software used for generating the metadata.
+  - arXiv DOI: [https://doi.org/10.48550/arXiv.1909.10039](https://doi.org/10.48550/arXiv.1909.10039)  
+  
+- Linking this document using only the **main release** (the ``Major.Minor``) as reference and forgetting the GitHub tag release, altough it could include changes which were not taken into account when the metadata was generated. As this document has ``Major.Minor = 1.2`` version
+  - GitHub dynamic page for the : [https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.2/](https://lagoproject.github.io/DMP/defs/lagoCollaboration.1.2/)
+  - CURL command against this GitHub dynamic page (TBD).
+
+
+## Plain JSON-LD file
+
+```json
+{% include_relative lagoCollaboration.1.2.jsonld %}
+```
+

defs/lagoCollaboration.jsonld

-{
-  "TBD" : "TBD."
-}