From e5152a747a0ed3019841aff3dd92f4b0f663c40c Mon Sep 17 00:00:00 2001 From: Steve Baskauf Date: Sun, 17 Sep 2023 15:23:18 -0500 Subject: [PATCH] move namespace doc to version, generate namespace header from template --- build/dwc_terms_namespace/index_template.md | 89 +++++++++++++++++++++ docs/namespace/2018-08-26.md | 87 ++++++++++++++++++++ docs/namespace/index.md | 19 +++-- 3 files changed, 190 insertions(+), 5 deletions(-) create mode 100644 build/dwc_terms_namespace/index_template.md create mode 100644 docs/namespace/2018-08-26.md diff --git a/build/dwc_terms_namespace/index_template.md b/build/dwc_terms_namespace/index_template.md new file mode 100644 index 0000000..6fd6dca --- /dev/null +++ b/build/dwc_terms_namespace/index_template.md @@ -0,0 +1,89 @@ +# {document_title} + +Title +: {document_title} + +Date version issued +: {ratification_date} + +Date created +: {created_date} + +Part of TDWG Standard +: <{standard_iri}> + +This version +: <{current_iri}{ratification_date}> + +Latest version +: <{current_iri}> + +{previous_version_slot} + +Abstract +: {abstract} + +Contributors +: {contributors} + +Creator +: {creator} + +Bibliographic citation +: {creator}. {year}. {document_title}. {publisher}. <{current_iri}{ratification_date}> + +## 1 Introduction + +This document and the policies contained herein are modeled on the [Dublin Core Metadata Initiative Namespace Policy](http://dublincore.org/documents/2007/07/02/dcmi-namespace/). All terms in the Darwin Core must be identified with a unique Uniform Resource Identifier (URI). For convenience, the term URIs are grouped into collections known as _Darwin Core namespaces_. This document describes the policies associated with Darwin Core namespaces and how term URIs are allocated by the [Darwin Core Maintenance Group](http://www.tdwg.org/activities/darwincore/). + +### 1.1 Status of the content of this document + +All sections of this document are normative. + +### 1.2 Audience + +This document is targeted toward those who want to make changes to the Darwin Core, either by refining terms that already exist or by adding new terms to increase the capabilities of the standard. + +## 2 Namespace URIs + +The Darwin Core namespace URI for the collection of general Darwin Core properties, classes, and encoding schemes is: + +``` +http://rs.tdwg.org/dwc/terms/ +``` + +The Darwin Core namespace URI for the collection Darwin Core properties expected to have IRI values is: + +``` +http://rs.tdwg.org/dwc/iri/ +``` + +The Darwin Core namespace URI for the collection of ChronometricAge properties, classes, and encoding schemes is: + +``` +http://rs.tdwg.org/chrono/terms/ +``` + +The term identifier for the current (recommended) version of a term is a URI based on the namespace and the term name without version information. Some example Darwin Core term identifiers follow: + +``` +http://rs.tdwg.org/dwc/terms/scientificName +``` + +is the Darwin Core term identifier for the `scientificName` property, while + +``` +http://rs.tdwg.org/dwc/terms/MachineObservation +``` + +is the Darwin Core term identifier for the `MachineObservation` class. + +All Darwin Core identifiers will dereference to a Darwin Core term declaration for the identified term. + +## 3 Term change policy + +(This section has been superseded by the [Vocabulary Maintenance Specification](https://github.com/tdwg/vocab/blob/master/vms/maintenance-specification.md)) + +## 4 Persistence policy + +[TDWG](https://www.tdwg.org/) recognizes that people and applications depend on the persistence of formal documents and machine processable schemas that have been made publicly available. In particular, the stability of Darwin Core term URIs and Darwin Core namespace URIs is critical to interoperability over time. Thus, the wide promulgation of this set of URIs dictates that they be maintained to support legacy applications that have adopted them. diff --git a/docs/namespace/2018-08-26.md b/docs/namespace/2018-08-26.md new file mode 100644 index 0000000..8acafcf --- /dev/null +++ b/docs/namespace/2018-08-26.md @@ -0,0 +1,87 @@ +# Darwin Core namespace policy + +Title +: Darwin Core namespace policy + +Date version issued +: 2018-08-26 + +Date created +: 2009-02-12 + +Part of TDWG Standard +: + +This version +: + +Latest version +: + +Previous version +: + +Replaced by +: + +Abstract +: All terms in the Darwin Core must be assigned a unique Uniform Resource Identifier (URI). For convenience, the term URIs that are assigned and managed by the Darwin Core Task Group are grouped into collections known as Darwin Core namespaces. This document describes how term URIs are allocated by the Darwin Core Maintenance Group and the policies associated with Darwin Core namespaces. + +Contributors +: John Wieczorek (MVZ), Markus Döring (GBIF), Renato De Giovanni (CRIA), Tim Robertson (GBIF), Dave Vieglais (KUNHM) + +Creator +: Darwin Core Task Group + +Bibliographic citation +: Darwin Core Task Group. 2009. Darwin Core Namespace Policy. Biodiversity Information Standards (TDWG). + +## 1 Introduction + +This document and the policies contained herein are modeled on the [Dublin Core Metadata Initiative Namespace Policy](http://dublincore.org/documents/2007/07/02/dcmi-namespace/). All terms in the Darwin Core must be identified with a unique Uniform Resource Identifier (URI). For convenience, the term URIs are grouped into collections known as _Darwin Core namespaces_. This document describes the policies associated with Darwin Core namespaces and how term URIs are allocated by the [Darwin Core Maintenance Group](http://www.tdwg.org/activities/darwincore/). + +### 1.1 Status of the content of this document + +All sections of this document are normative. + +### 1.2 Audience + +This document is targeted toward those who want to make changes to the Darwin Core, either by refining terms that already exist or by adding new terms to increase the capabilities of the standard. + +## 2 Namespace URIs + +The Darwin Core namespace URI for the collection of general Darwin Core properties, classes, and encoding schemes is: + +``` +http://rs.tdwg.org/dwc/terms/ +``` + +The Darwin Core namespace URI for the collection Darwin Core properties expected to have IRI values is: + +``` +http://rs.tdwg.org/dwc/iri/ +``` + +The term identifier for the current (recommended) version of a term is a URI based on the namespace and the term name without version information. Some example Darwin Core term identifiers follow: + +``` +http://rs.tdwg.org/dwc/terms/scientificName +``` + +is the Darwin Core term identifier for the `scientificName` property, while + +``` +http://rs.tdwg.org/dwc/terms/MachineObservation +``` + +is the Darwin Core term identifier for the `MachineObservation` class. + +All Darwin Core identifiers will dereference to a Darwin Core term declaration for the identified term. + +## 3 Term change policy + +(This section has been superseded by the [Vocabulary Maintenance Specification](https://github.com/tdwg/vocab/blob/master/vms/maintenance-specification.md)) + +## 4 Persistence policy + +[TDWG](https://www.tdwg.org/) recognizes that people and applications depend on the persistence of formal documents and machine processable schemas that have been made publicly available. In particular, the stability of Darwin Core term URIs and Darwin Core namespace URIs is critical to interoperability over time. Thus, the wide promulgation of this set of URIs dictates that they be maintained to support legacy applications that have adopted them. diff --git a/docs/namespace/index.md b/docs/namespace/index.md index 413e452..dd5368f 100644 --- a/docs/namespace/index.md +++ b/docs/namespace/index.md @@ -3,26 +3,35 @@ Title : Darwin Core namespace policy -Date modified -: 2023-09-14 +Date version issued +: 2023-09-13 Date created : 2009-02-12 Part of TDWG Standard -: +: + +This version +: + +Latest version +: + +Previous version +: Abstract : All terms in the Darwin Core must be assigned a unique Uniform Resource Identifier (URI). For convenience, the term URIs that are assigned and managed by the Darwin Core Task Group are grouped into collections known as Darwin Core namespaces. This document describes how term URIs are allocated by the Darwin Core Maintenance Group and the policies associated with Darwin Core namespaces. Contributors -: John Wieczorek (MVZ), Markus Döring (GBIF), Renato De Giovanni (CRIA), Tim Robertson (GBIF), Dave Vieglais (KUNHM) +: [John Wieczorek](https://orcid.org/0000-0003-1144-0290) ([VertNet](http://www.wikidata.org/entity/Q98382028)), [Markus Döring](https://orcid.org/0000-0001-7757-1889) ([Global Biodiversity Information Facility](http://www.wikidata.org/entity/Q1531570)), [Renato De Giovanni](https://orcid.org/0000-0002-7104-7266) ([Centro de Referência em Informação Ambiental](http://www.wikidata.org/entity/Q29168927)), [Tim Robertson](https://orcid.org/0000-0001-6215-3617) ([Global Biodiversity Information Facility](http://www.wikidata.org/entity/Q1531570)), [Dave Vieglais](https://orcid.org/0000-0002-6513-4996) ([KU Natural History Museum](http://www.wikidata.org/entity/Q1111807)), [Gail Kampmeier](https://orcid.org/0000-0002-5178-4170) ([Illinois Natural History Survey](http://www.wikidata.org/entity/Q5999587)) Creator : Darwin Core Task Group Bibliographic citation -: Darwin Core Task Group. 2009. Darwin Core Namespace Policy. Biodiversity Information Standards (TDWG). +: Darwin Core Task Group. 2023. Darwin Core namespace policy. Biodiversity Information Standards (TDWG). ## 1 Introduction