<div dir="ltr">Hello,<div><br></div><div>Well, thinking about this at 6am without having had coffee yet...</div><div><br></div><div>In the context of data, &quot;documentation&quot; and &quot;metadata&quot; are very nearly synonymous. The term &quot;machine-readable&quot; meant something quite different when I started in this business (back when dinosaurs roamed the Earth providing tech support), but now it seems to have evolved to mean what we would have called &quot;machine-actionable&quot;. Even still that&#39;s not as clear a line as we might like.A PDF document, for example, is machine-readable: it takes a computer to turn it into something that is human-readable and it is also possible to extract text, tables, and other items from a PDF file. But I don&#39;t think anyone wants to see PDF headers for data. Machine-readable headers are often human-readable as well, by design (like FITS).  (There are binary headers out there in some formats that are <i>not</i> human-readable, but I suspect they do not show up in IVOA repositories as data files.)</div><div><br></div><div>So, from my still-learning and yet aging perspective, I would expect that &quot;documentation&quot; would be the broadest term, that &quot;metadata&quot; would be a subtype of documentation with the stipulation that it is documentation provided in a format that conforms to a published standard that makes it machine-readable. &quot;Header&quot; would then be a subtype of &quot;metadata&quot; that is tightly bound to #this, with the further restriction that it provides some metadata that is unique to #this (otherwise why carry it along?). If we have a need to identify documentation that is not machine-readable (PDFs would qualify in the IVOA context), then there is probably another subtype of #documentation lurking in the wings. If we require that all documentation be machine-readable, then &quot;documentation&quot; and &quot;metadata&quot; are synonymous in the IVOA context, and there is no need for two terms.</div><div><br></div><div>Coffee time...</div><div><br></div><div><div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr">-Anne.</div></div></div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Sep 15, 2021 at 5:26 AM BONNAREL FRANCOIS &lt;<a href="mailto:francois.bonnarel@astro.unistra.fr">francois.bonnarel@astro.unistra.fr</a>&gt; wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi all,<br>
        I know that VEP-007 will be discussed today and I will not <br>
participate.<br>
        I got no answer to this email except recently from Markus in a <br>
private discussion.<br>
        I am strongly in favor of the new term itself.<br>
        My small concern (with a proposal) is that as it is stated now <br>
in &quot;<a href="https://volute.g-vo.org/svn/trunk/projects/semantics/veps/VEP-007.txt" rel="noreferrer" target="_blank">https://volute.g-vo.org/svn/trunk/projects/semantics/veps/VEP-007.txt</a>&quot;<br>
        The head-term of #detached-header is &quot;documentation&quot;.<br>
        I think that a head term like #metadata would be better.<br>
        This term doesn&#39;t exist  up to now and I think it is  lacking.<br>
        #metadata is different from #documentation in the sense that the <br>
first one is machine readable while the other one is human readable<br>
        So usage by clients would be very different. Other example for <br>
#metadata would be #ivoa-provenance-metadata and #ivoa-obscore<br>
        If you think this is a good idea I would like to add this term <br>
either in the same VEP or as another VEP with the small modification of <br>
head-term in VEP-007 itself<br>
Cheers<br>
François<br>
<br>
Le 16/06/2021 à 09:20, BONNAREL FRANCOIS a écrit :<br>
&gt; Hi all,<br>
&gt; Very interesting proposal indeed.<br>
&gt; I&#39;m just wondering if we could take the opportunity to create a new <br>
&gt; #metadata branch .<br>
&gt; So that &quot;#detached-header&quot; would be a child of this head term #metadata<br>
&gt; Other children terms in the future could be #provenance_record (to <br>
&gt; attach ivoa provenance serailisation to #this), #obscore_record (to <br>
&gt; attche obscore metadata to #this when the dataset was not discovered <br>
&gt; via an ObsCoredelivering service) etc ....<br>
&gt; Cheers<br>
&gt; François<br>
&gt; Le 16/06/2021 à 09:13, Baptiste Cecconi a écrit :<br>
&gt;&gt; Hi all,<br>
&gt;&gt;<br>
&gt;&gt; I received an direct comment from Anne Raugh, and have updated the <br>
&gt;&gt; Rationale of VEP-007 accordingly. I copy the new content of the <br>
&gt;&gt; Rationale section below:<br>
&gt;&gt;<br>
&gt;&gt;&gt; Rationale:<br>
&gt;&gt;&gt; In some formats and archives, the metadata required to decode the<br>
&gt;&gt;&gt; content of #this is in a separate file. In the case of NASA/PDS<br>
&gt;&gt;&gt; data products, for example, the PDS label file contains the decoding<br>
&gt;&gt;&gt; metadata. In some archives, the FITS header may be stored separately<br>
&gt;&gt;&gt; as a plain text file, next to a data file consisting of a binary<br>
&gt;&gt;&gt; stream of bytes. Clients would use the content type (MIME type)<br>
&gt;&gt;&gt; (e.g.: application/x-pds4-label+xml, or text/x-pds3-label) to enable<br>
&gt;&gt;&gt; the processing.<br>
&gt;&gt;&gt;<br>
&gt;&gt; Cheers<br>
&gt;&gt; Baptiste<br>
&gt;<br>
&gt;<br>
<br>
</blockquote></div>