Skip to content

Commit

Permalink
minor edits to prepare for submission for review
Browse files Browse the repository at this point in the history
  • Loading branch information
Steve Baskauf committed Aug 2, 2016
1 parent 1f20dc9 commit 76a4427
Show file tree
Hide file tree
Showing 7 changed files with 101 additions and 65 deletions.
Binary file added code-examples/darwin-core/dwc-rdf.zip
Binary file not shown.
8 changes: 4 additions & 4 deletions documentation-specification.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TDWG Standards Documentation Specification (draft of 2016-08-01) #
# TDWG Standards Documentation Specification (draft of 2016-08-02 as submitted for review) #

**Title:** Standards Documentation Specification

Expand All @@ -14,7 +14,7 @@

**Abstract:** This document defines how TDWG standards are to be presented. It provides details about the hierarchical structure of standards and versioning of standards components. It specifies how the properties of standards and their components are to be described in human-readable and machine-readable terms.

**Contributors:** Steve Baskauf (TDWG Vocabulary Maintenance Specification Task Group), Roger Hyam (TDWG Infrastructure Project), Stanley Blum (TDWG Process Interest Group), Robert A. Morris (TDWG Imaging Interest Group), Jonathan Rees, Joel Sachs (TDWG RDF Task Group), Greg Whitbread (TDWG Technical Architecture Group), John Wieczorek (TDWG Darwin Core Task Group). Review editor: _______
**Contributors:** Steve Baskauf (TDWG Vocabulary Maintenance Specification Task Group), Roger Hyam (TDWG Infrastructure Project), Stanley Blum (TDWG Process Interest Group), Robert A. Morris (UMASS-Boston, TDWG Imaging Interest Group), Jonathan Rees (Duke University), Joel Sachs (TDWG RDF Task Group), Greg Whitbread (TDWG Technical Architecture Group), John Wieczorek (TDWG Darwin Core Task Group). Review editor: _______

**Creator:** TDWG Vocabulary Maintenance Specification Task Group

Expand Down Expand Up @@ -554,7 +554,7 @@ The following properties with appropriate values SHOULD be used to describe a st
|**Human-readable label** | **Machine-readable property** | **Type of value** |
|-------------------------|-------------------------------|-------------------|
| Title | dcterms:title, rdfs:label * | literal |
| Publisher | dc:publisher | literal containing "Biodiversity Information Standards (TDWG)"|
| Publisher | dc:publisher | literal consisting of "Biodiversity Information Standards (TDWG)"|

\* Both of these terms are well-known properties used to indicate a human-readable label for a resource. Including both increases the likelihood that a consuming application will be able to present that label to human users.

Expand Down Expand Up @@ -596,7 +596,7 @@ The property dcterms:contributor SHOULD be used to link the document or vocabula
"Renato de Giovanni (CRIA)",
"Dave Vieglais (KUNHM)";
dcterms:contributor <http://orcid.org/0000-0001-6215-3617>,
[foaf:familyName "Wieczorek"; foaf:givenName "John"],
<http://orcid.org/0000-0003-1144-0290>,
<http://orcid.org/0000-0001-7757-1889>,
[foaf:familyName "de Giovanni"; foaf:givenName "Renato"],
<http://orcid.org/0000-0002-6513-4996>;
Expand Down
37 changes: 21 additions & 16 deletions documentation-specification.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,12 @@
@prefix dcterms: <http://purl.org/dc/terms/>.
@prefix owl: <http://www.w3.org/2002/07/owl#>.
@prefix foaf: <http://xmlns.com/foaf/0.1/>.


# This file is part of the main submission for review of the Standards Documentation Specification on 2016-08-02.
# These metadata are provisional. Some adjustments to this information may need to be made as IRIs are settled,
# as dates are determined, review managers chosen, and
# if substantive changes are made in the documentation specifications for machine-readable metadata.

<http://www.tdwg.org/standards/147>
dcterms:hasPart <http://something.tdwg.org/sds>;
dcterms:hasVersion <http://www.tdwg.org/standards/147#2016-12-04>;
Expand All @@ -21,7 +26,7 @@

<http://www.tdwg.org/standards/147#2016-12-04>
owl:versionInfo "2016-12-04";
dcterms:hasPart <http://something.tdwg.org/sds/2016-07-31>;
dcterms:hasPart <http://something.tdwg.org/sds/2016-08-02>;
dcterms:isVersionOf <http://www.tdwg.org/standards/147>;
dcterms:issued "2016-12-04"^^xsd:date; #change this to ratification date
dcterms:title "Standards Documentation Standard (2016-12-04 release)"@en;
Expand All @@ -33,18 +38,18 @@

<http://something.tdwg.org/sds>
dcterms:isPartOf <http://www.tdwg.org/standards/147>;
dcterms:hasVersion <http://something.tdwg.org/sds/2016-08-01>;
dcterms:hasVersion <http://something.tdwg.org/sds/2016-08-02>;
dcterms:hasVersion <http://something.tdwg.org/sds/2007-11-05>;
dcterms:isReferencedBy <http://something.tdwg.org/sds.ttl>;
dcterms:created "2007-06-06"^^xsd:date;
dcterms:modified "2016-08-01"^^xsd:date ; #change this to date of the last version before ratification
dcterms:modified "2016-08-02"^^xsd:date ; #change this to date of the last version before ratification
dcterms:title "Standards Documentation Specification"@en;
rdfs:label "Standards Documentation Specification"@en;
a foaf:Document;
dc:contributor "Steven J. Baskauf (TDWG Vocabulary Maintenance Specification Task Group)",
"Roger Hyam (TDWG Infrastructure Project)",
"Stanley Blum (TDWG Process Interest Group)",
"Robert A. Morris (TDWG Imaging Interest Group)",
"Robert A. Morris (UMASS-Boston, TDWG Imaging Interest Group)",
"Jonathan A. Rees",
"Joel Sachs (TDWG RDF Task Group)",
"Greg Whitbread (TDWG Technical Architecture Group)",
Expand All @@ -53,26 +58,26 @@
dcterms:contributor <http://orcid.org/0000-0003-4365-3135>,
<http://orcid.org/0000-0003-4581-1379>,
[foaf:familyName "Blum"; foaf:givenName "Stanley";rdfs:label "Stanley Blum"],
[foaf:familyName "Morris"; foaf:givenName "Robert A.";rdfs:label "Stanley Blum"],
[foaf:familyName "Morris"; foaf:givenName "Robert A.";rdfs:label "Robert A. Morris"],
<http://orcid.org/0000-0001-7694-8250>,
[foaf:familyName "Sachs"; foaf:givenName "Joel";rdfs:label "Joel Sachs"],
[foaf:familyName "Whitbread"; foaf:givenName "Greg";rdfs:label "Greg Whitbread"],
[foaf:familyName "Wieczorek"; foaf:givenName "John";rdfs:label "John Wieczorek"],
<http://orcid.org/0000-0003-1144-0290>,
<http://orcid.org/x>; #add review editor's ORCID ID
dc:creator "TDWG Vocabulary Maintenance Specification Task Group";
dcterms:license <http://creativecommons.org/licenses/by/4.0/>;
dcterms:description "This document defines how TDWG standards are to be presented. It provides details about the hierarchical structure of standards and versioning of standards components. It specifies how the properties of standards and their components are to be described in human-readable and machine-readable terms.";
rdfs:comment "This document defines how TDWG standards are to be presented. It provides details about the hierarchical structure of standards and versioning of standards components. It specifies how the properties of standards and their components are to be described in human-readable and machine-readable terms.";
dcterms:bibliographicCitation "Vocabulary Maintenance Specification Task Group. 2016. Standards Documentation Specification. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/147 (accessed on [date]).".

<http://something.tdwg.org/sds/2016-08-01>
owl:versionInfo "2016-08-01";
<http://something.tdwg.org/sds/2016-08-02>
owl:versionInfo "2016-08-02";
dcterms:isPartOf <http://www.tdwg.org/standards/147#2016-12-04>;
dcterms:replaces <http://something.tdwg.org/sds/2007-11-05>;
dcterms:isVersionOf <http://something.tdwg.org/sds>;
dcterms:issued "2016-08-01"^^xsd:date;
dcterms:title "Standards Documentation Specification (2016-08-01 version)"@en;
rdfs:label "Standards Documentation Specification (2016-08-01 version)"@en;
dcterms:issued "2016-08-02"^^xsd:date;
dcterms:title "Standards Documentation Specification (2016-08-02 version)"@en;
rdfs:label "Standards Documentation Specification (2016-08-02 version)"@en;
a foaf:Document;
dc:contributor "Steven J. Baskauf (TDWG Vocabulary Maintenance Specification Task Group)",
"Roger Hyam (TDWG Infrastructure Project)",
Expand All @@ -86,11 +91,11 @@
dcterms:contributor <http://orcid.org/0000-0003-4365-3135>,
<http://orcid.org/0000-0003-4581-1379>,
[foaf:familyName "Blum"; foaf:givenName "Stanley";rdfs:label "Stanley Blum"],
[foaf:familyName "Morris"; foaf:givenName "Robert A.";rdfs:label "Stanley Blum"],
[foaf:familyName "Morris"; foaf:givenName "Robert A.";rdfs:label "Robert A. Morris"],
<http://orcid.org/0000-0001-7694-8250>,
[foaf:familyName "Sachs"; foaf:givenName "Joel";rdfs:label "Joel Sachs"],
[foaf:familyName "Whitbread"; foaf:givenName "Greg";rdfs:label "Greg Whitbread"],
[foaf:familyName "Wieczorek"; foaf:givenName "John";rdfs:label "John Wieczorek"],
<http://orcid.org/0000-0003-1144-0290>,
<http://orcid.org/x>; #add review editor's ORCID ID
dc:creator "TDWG Vocabulary Maintenance Specification Task Group";
dcterms:license <http://creativecommons.org/licenses/by/4.0/>;
Expand All @@ -100,7 +105,7 @@

<http://something.tdwg.org/sds/2007-11-05>
owl:versionInfo "2007-11-05";
dcterms:isReplacedBy <http://something.tdwg.org/sds/2016-08-01>;
dcterms:isReplacedBy <http://something.tdwg.org/sds/2016-08-02>;
dcterms:isVersionOf <http://something.tdwg.org/sds>;
dcterms:issued "2007-11-05"^^xsd:date;
dcterms:title "TDWG Standards Documentation Specification"@en;
Expand All @@ -117,4 +122,4 @@
dcterms:references <http://www.tdwg.org/standards/147>;
dcterms:references <http://something.tdwg.org/sds>;
dc:format "text/turtle";
dcterms:modified "2016-08-01T07:33:00-05:00"^^xsd:dateTime.
dcterms:modified "2016-08-02T16:00:00-05:00"^^xsd:dateTime.
26 changes: 26 additions & 0 deletions dwc-namespace-remnant.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
## This material will remain a part of the Darwin Core Namespace Policy, with minor edits. The parts of the existing Namespace Policy page that are not present here have been incorporated into the Vocabulary Maintenance Specification


1\. Introduction

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.
This document and the policies contained herein are modeled on the Dublin Core Metadata Initiative Namespace Policy [DCMINAMESPACEPOLICY]. 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 Task Group [DWC-TASK].

2\. Namespace URIs

The Darwin Core namespace URI for the collection of all Darwin Core properties, classes, and encoding schemes is:

http://rs.tdwg.org/dwc/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\. Persistence Policy

TDWG 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.
31 changes: 2 additions & 29 deletions maintenance-specification.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TDWG Vocabulary Maintenance Specification (draft of 2015-07-31)
# TDWG Vocabulary Maintenance Specification (draft of 2016-08-02 as submitted for review)

**Title:** Vocabulary Maintenance Specification

Expand All @@ -14,7 +14,7 @@

**Abstract:** This document describes the processes used to modify TDWG vocabularies and their associated documents.

**Contributors:** Steve Baskauf (TDWG Vocabulary Maintenance Specification Task Group), John Wieczorek (TDWG Darwin Core Interest Group), Stan Blum (TDWG Process Interest Group), Robert A. Morris (TDWG Imaging Interest Group), Jonathan Rees, Joel Sachs (TDWG RDF Task Group), Greg Whitbread (TDWG Technical Architecture Group). Review editor: _______
**Contributors:** Steve Baskauf (TDWG Vocabulary Maintenance Specification Task Group), John Wieczorek (TDWG Darwin Core Interest Group), Stan Blum (TDWG Process Interest Group), Robert A. Morris (UMASS-Boston, TDWG Imaging Interest Group), Jonathan Rees (Duke University), Joel Sachs (TDWG RDF Task Group), Greg Whitbread (TDWG Technical Architecture Group). Review editor: _______

**Creator:** TDWG Vocabulary Maintenance Specification Task Group

Expand Down Expand Up @@ -274,30 +274,3 @@ If the proposed enhancement is adopted as part of the vocabulary standard, the i
This document is licensed under a [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/). ![http://creativecommons.org/licenses/by/4.0/](https://licensebuttons.net/l/by/4.0/88x31.png).

Copyright 2016 - Biodiversity Information Standards - TDWG - [Contact Us](http://www.tdwg.org/about-tdwg/contact-us/)

---------------------------
## The sections below this point will remain a part of the Darwin Core Namespace Policy, with minor edits. ##

1\. Introduction

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.
This document and the policies contained herein are modeled on the Dublin Core Metadata Initiative Namespace Policy [DCMINAMESPACEPOLICY]. 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 Task Group [DWC-TASK].

2\. Namespace URIs

The Darwin Core namespace URI for the collection of all Darwin Core properties, classes, and encoding schemes is:

http://rs.tdwg.org/dwc/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\. Persistence Policy

TDWG 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.
Loading

0 comments on commit 76a4427

Please sign in to comment.