Difference: VEPs (1 vs. 2)

Revision 22019-09-05 - MarkusDemleitner

 
META TOPICPARENT name="IvoaSemantics"
Changed:
<
<
Note: This is a proposal by MarkusDemleitner for how to manage vocabulary evolution in the IVOA at this point.
>
>
Note: VEPs are proposed in a draft of version 2.0 of Vocabularies. This currently is in the state of a proof of concept.
 
Added:
>
>
The next VEP will have the running number 0001. Please update this after uploading a new VEP.
 

VEPs"> Current VEPs

Changed:
<
<
>
>
(None yet)
 
Deleted:
<
<
(please attach your VEP and put the link into this enumeration)
 

VEPs"> Accepted VEPs

(None so far)

Vocabulary Enhancement Requests (VEPs)

Changed:
<
<
We propose to manage vocabulary evolution in the IVOA through Vocabulary Enhancement Requests. These are small, version controllable, plain text files; the current version of a VEP is maintained on this page, currently in an attachment.
>
>
See Vocabularies in the VO version 2 [TODO: add a link once it's updated] for how to write VEPs and how they are processed.
Deleted:
<
<
A VEP is semistructured; in a header, it should first give the vocabulary URL and a contact address for the author, as in

Vocabulary: http://www.ivoa.net/rdf/datalink/core
Author: msdemlei@ari.uni-heidelberg.de

This is followed by one or more blocks. These can be proposals for new terms, given with a human-readable label, a description, and a rationale for the addition. For instance:

New Term: isMetadataFor (child of auxiliary)
Label: Metadata
Description: additional documentation for this dataset (e.g.,
observatory logs, provenance information)
Rationale: This would annotate material such as observation logs,
scanned envelopes of plates, or possibly logs of pipeline runs.  The
term is a bit different from other datalink terms, but it is taken from
the DataCite relationships, and I feel re-using these terms whenever
possible makes it easier to re-use datalink annotations later.

Alternatively, changes to an existing term can be proposed, including changing its parent:

Changed term: proc
Label: Processing
Description: reference to a server-side processing service
Rationale: The old description ("server-side data processing result")
just doesn't quite match what this is.

No process for the deletion of terms is proposed at this point.

A VEP may be replaced during discussions.

 
<--  
-->

META FILEATTACHMENT attachment="vep001.txt" attr="" comment="" date="1467643673" name="vep001.txt" path="vep001.txt" size="1921" user="MarkusDemleitner" version="1"

Revision 12016-07-04 - MarkusDemleitner

 
META TOPICPARENT name="IvoaSemantics"
Note: This is a proposal by MarkusDemleitner for how to manage vocabulary evolution in the IVOA at this point.

VEPs"> Current VEPs

(please attach your VEP and put the link into this enumeration)

VEPs"> Accepted VEPs

(None so far)

Vocabulary Enhancement Requests (VEPs)

We propose to manage vocabulary evolution in the IVOA through Vocabulary Enhancement Requests. These are small, version controllable, plain text files; the current version of a VEP is maintained on this page, currently in an attachment.

A VEP is semistructured; in a header, it should first give the vocabulary URL and a contact address for the author, as in

Vocabulary: http://www.ivoa.net/rdf/datalink/core
Author: msdemlei@ari.uni-heidelberg.de

This is followed by one or more blocks. These can be proposals for new terms, given with a human-readable label, a description, and a rationale for the addition. For instance:

New Term: isMetadataFor (child of auxiliary)
Label: Metadata
Description: additional documentation for this dataset (e.g.,
observatory logs, provenance information)
Rationale: This would annotate material such as observation logs,
scanned envelopes of plates, or possibly logs of pipeline runs.  The
term is a bit different from other datalink terms, but it is taken from
the DataCite relationships, and I feel re-using these terms whenever
possible makes it easier to re-use datalink annotations later.

Alternatively, changes to an existing term can be proposed, including changing its parent:

Changed term: proc
Label: Processing
Description: reference to a server-side processing service
Rationale: The old description ("server-side data processing result")
just doesn't quite match what this is.

No process for the deletion of terms is proposed at this point.

A VEP may be replaced during discussions.


<--  
-->

META FILEATTACHMENT attachment="vep001.txt" attr="" comment="" date="1467643673" name="vep001.txt" path="vep001.txt" size="1921" user="MarkusDemleitner" version="1"
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback