VEP-002.txt

Vocabulary: http://www.ivoa.net/rdf/datalink/core
Author: francois.bonnarel@astro.unistra.fr
Date: 2019-10-15

New Term: documentation 
Action: Addition
Label: Documentation
Description: Extra information on the item in human-readable text form,
  ranging from processing logs to weather reports to technical documents
  on instruments to related publications.
Rationale: 
This term was proposed actually by Alberto Micol due to some ESO use cases. For example a text giving some details on observation conditions can be attached to a dataset. Could be also instrument configuration in free text, etc...

Discussion: Semantics took the liberty of modifying term, label and
description versus the original proposal to better fit into the existing
vocabulary and be a bit more precise.

SVO wants to use the term to link to related publications, for instance
where the dataset was used or commented on (cf.
http://svo2.cab.inta-csic.es/vocats/v2/ltsa/dl.php?ID=SDSS_J12181286%2B0706104).
CADC mentioned there's a simiar thing in CAOM that is used to link to
pocessing logs.  Semantics then asked whether there is sufficent
communalities between the different use cases to have them all under one
term and what a client is supposed to do with it; SVO indicated that
there probably was and the single "documentation" was sufficient
(http://mail.ivoa.net/pipermail/dal/2019-October/008208.html)