Skip to content

Commit

Permalink
changes for submission for public comment
Browse files Browse the repository at this point in the history
  • Loading branch information
Steve Baskauf committed Jan 23, 2017
1 parent 37df2a5 commit 74f81c8
Show file tree
Hide file tree
Showing 9 changed files with 63 additions and 62 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ Here are some key documents that form crucial background for our discussions:

[Use cases and implementation reports in standards and vocabulary development](implementation-use-cases.md)

[Draft hierarchy model of 2016-07-24](hierarchy-model.md)
[Draft hierarchy model of 2017-01-23](hierarchy-model.md)

[Notes on a preliminary hierarchy model including definitions and use cases](hierarchy-model-2015-07-15.md)

Expand All @@ -81,4 +81,4 @@ Here are some key documents that form crucial background for our discussions:

## Preferred citation

> Vocabulary Maintenance Specification task group. 2015. Vocabulary Maintenance Specification (VOCAB), Version 0.1. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/147
> Vocabulary Maintenance Specification task group. 2017. Vocabulary Maintenance Specification (VOCAB), Version 2017-01-23. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/147
Binary file modified diagrams.pptx
Binary file not shown.
6 changes: 3 additions & 3 deletions documentation-specification.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TDWG Standards Documentation Specification (draft of 2017-01-20 revised based on reviewer comments) #
# TDWG Standards Documentation Specification (draft of 2017-01-23 for submission for public comment) #

**Title:** Standards Documentation Specification

Expand All @@ -8,7 +8,7 @@

**Part of TDWG Standard:** http://www.tdwg.org/standards/147

**This version:** http://something.tdwg.org/x/2016-x-x
**This version:** http://something.tdwg.org/x/2017-x-x

**Latest version:** http://something.tdwg.org/x

Expand Down Expand Up @@ -442,7 +442,7 @@ Term lists containing terms defined by TDWG SHOULD include the following items i

Each term entry on the list SHOULD include the following items.

**Term name** (REQUIRED) - The term name is a controlled value that represents the class, property, or concept described by the term definition. The term name is composed of the local name part of the term IRI, with a prepended namespace abbreviation (QName) that is defined in the header section of the vocabulary list document. [RECIPES] The term name is often related to the meaning of the term, but users MUST NOT attempt to understand the meaning of the term by interpreting its name. Rather, the term definition MUST be consulted.
**Term name** (REQUIRED) - The term name is a controlled value that represents the class, property, or concept described by the term definition. The term name is composed of the local name part of the term IRI, with a prepended namespace abbreviation (QName) that is defined in the header section of the vocabulary list document [RECIPES]. The term name is often related to the meaning of the term, but users MUST NOT attempt to understand the meaning of the term by interpreting its name. Rather, the term definition MUST be consulted.

**Label** (RECOMMENDED) - The label is a word or short phrase that serves as a human-readable name for the term.

Expand Down
48 changes: 24 additions & 24 deletions documentation-specification.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -13,44 +13,44 @@

<http://www.tdwg.org/standards/147>
dcterms:hasPart <http://something.tdwg.org/sds>;
dcterms:hasVersion <http://www.tdwg.org/standards/147#2016-12-04>;
dcterms:hasVersion <http://www.tdwg.org/standards/147#2017-01-23>;
dcterms:isReferencedBy <http://something.tdwg.org/sds.ttl>;
dcterms:created "2016-12-04"^^xsd:date; #change this to ratification date
dcterms:modified "2016-12-04"^^xsd:date ; #change this to ratification date
dcterms:created "2017-01-23"^^xsd:date; #change this to ratification date
dcterms:modified "2017-01-23"^^xsd:date ; #change this to ratification date
dcterms:title "Standards Documentation Standard"@en;
rdfs:label "Standards Documentation Standard"@en;
a dcterms:Standard;
dc:publisher "Biodiversity Information Standards (TDWG)";
dcterms:description "The TDWG Standards Documentation Standard consists of a single document: the Standards Documentation Specification."@en;
rdfs:comment "The TDWG Standards Documentation Standard consists of a single document: the Standards Documentation Specification."@en.

<http://www.tdwg.org/standards/147#2016-12-04>
owl:versionInfo "2016-12-04";
dcterms:hasPart <http://something.tdwg.org/sds/2016-08-02>;
<http://www.tdwg.org/standards/147#2017-01-23>
owl:versionInfo "2017-01-23";
dcterms:hasPart <http://something.tdwg.org/sds/2017-01-23>;
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;
rdfs:label "Standards Documentation Standard (2016-12-04 release)"@en;
dcterms:issued "2017-01-23"^^xsd:date; #change this to ratification date
dcterms:title "Standards Documentation Standard (2017-01-23 release)"@en;
rdfs:label "Standards Documentation Standard (2017-01-23 release)"@en;
a dcterms:Standard;
dc:publisher "Biodiversity Information Standards (TDWG)";
dcterms:description "The TDWG Standards Documentation Standard consists of a single document: the Standards Documentation Specification."@en;
rdfs:comment "The TDWG Standards Documentation Standard consists of a single document: the Standards Documentation Specification."@en.

<http://something.tdwg.org/sds>
dcterms:isPartOf <http://www.tdwg.org/standards/147>;
dcterms:hasVersion <http://something.tdwg.org/sds/2016-08-02>;
dcterms:hasVersion <http://something.tdwg.org/sds/2017-01-23>;
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-02"^^xsd:date ; #change this to date of the last version before ratification
dcterms:modified "2017-01-23"^^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 (UMASS-Boston, TDWG Imaging Interest Group)",
"Jonathan A. Rees",
"Jonathan A. Rees (Duke University)",
"Joel Sachs (TDWG RDF Task Group)",
"Greg Whitbread (TDWG Technical Architecture Group)",
"John Wieczorek (TDWG Darwin Core Task Group)",
Expand All @@ -68,26 +68,26 @@
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]).".
dcterms:bibliographicCitation "Vocabulary Maintenance Specification Task Group. 2017. Standards Documentation Specification. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/147 (accessed on [date]).".

<http://something.tdwg.org/sds/2016-08-02>
owl:versionInfo "2016-08-02";
dcterms:isPartOf <http://www.tdwg.org/standards/147#2016-12-04>;
<http://something.tdwg.org/sds/2017-01-23>
owl:versionInfo "2017-01-23";
dcterms:isPartOf <http://www.tdwg.org/standards/147#2017-01-23>;
dcterms:replaces <http://something.tdwg.org/sds/2007-11-05>;
dcterms:isVersionOf <http://something.tdwg.org/sds>;
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;
dcterms:title "Standards Documentation Specification (2017-01-23 version)"@en;
rdfs:label "Standards Documentation Specification (2017-01-23 version)"@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)",
"Jonathan A. Rees",
"Jonathan A. Rees (Duke University)",
"Joel Sachs (TDWG RDF Task Group)",
"Greg Whitbread (TDWG Technical Architecture Group)",
"John Wieczorek (TDWG Darwin Core Task Group)",
"(review editor)";
"Dag Endresen (GBIF Norway/NHM University of Oslo; review editor)";
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"],
Expand All @@ -96,16 +96,16 @@
[foaf:familyName "Sachs"; foaf:givenName "Joel";rdfs:label "Joel Sachs"],
[foaf:familyName "Whitbread"; foaf:givenName "Greg";rdfs:label "Greg Whitbread"],
<http://orcid.org/0000-0003-1144-0290>,
<http://orcid.org/x>; #add review editor's ORCID ID
<http://orcid.org/0000-0002-2352-5497>;
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]).".
dcterms:bibliographicCitation "Vocabulary Maintenance Specification Task Group. 2017. Standards Documentation Specification. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/147 (accessed on [date]).".

<http://something.tdwg.org/sds/2007-11-05>
owl:versionInfo "2007-11-05";
dcterms:isReplacedBy <http://something.tdwg.org/sds/2016-08-02>;
dcterms:isReplacedBy <http://something.tdwg.org/sds/2017-01-23>;
dcterms:isVersionOf <http://something.tdwg.org/sds>;
dcterms:issued "2007-11-05"^^xsd:date;
dcterms:title "TDWG Standards Documentation Specification"@en;
Expand All @@ -122,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-02T16:00:00-05:00"^^xsd:dateTime.
dcterms:modified "2017-01-23T06:00:00-06:00"^^xsd:dateTime.
4 changes: 2 additions & 2 deletions hierarchy-model.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
#TDWG Hierarchy Model
Draft 2016-07-24 - Steve Baskauf - TDWG Vocabulary Management Task Group
Draft 2017-01-23 - Steve Baskauf - TDWG Vocabulary Management Task Group

Note: This diagram represents the model under consideration as part of the [draft Standards Documentation Standard](documentation-specification.md).

![](https://raw.githubusercontent.com/tdwg/vocab/master/tdwg-standards-hierarchy-2016-07-24.png)
![](https://raw.githubusercontent.com/tdwg/vocab/master/tdwg-standards-hierarchy-2017-01-23.png)


Note: each kind of resource described here can exist as a current resource and as versioned resources as described in the [version model](version-model.md).
Expand Down
4 changes: 2 additions & 2 deletions maintenance-specification.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# TDWG Vocabulary Maintenance Specification (draft of 2017-01-20 revised based on reviewer comments)
# TDWG Vocabulary Maintenance Specification (draft of 2017-01-23 for submission for public comment)

**Title:** Vocabulary Maintenance Specification

Expand All @@ -8,7 +8,7 @@

**Part of TDWG Standard:** http://www.tdwg.org/standards/x

**This version:** http://something.tdwg.org/x/2016-x-x
**This version:** http://something.tdwg.org/x/2017-x-x

**Latest version:** http://something.tdwg.org/x

Expand Down
Loading

0 comments on commit 74f81c8

Please sign in to comment.