VOTable14WorkingDraftNotes < IVOA

IVOA Web>IvoaApplications>VOTable14WorkingDraftNotes (2019-06-03, TomDonaldson) (raw view)
---+ VOTable 1.4 Working Draft Notes

*This page is now frozen.* Please make future comments on <span style="text-decoration: underline;">[[VOTable14RFC][VOTable 1.4 Request For Comments]]. -- IVOA.TomDonaldson - 2019-05-03</span>
---

---++ Change Logs for WD-VOTable-1.4

| *Description* | *Source* | *volute Revision(s)* |
| <p> </p> *Between <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190403/" title="Working draft 1.4 2019-04-03">WD-VOTable-1.4.20190403</a> and <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190604/" title="Proposed recommendation 1.4 2019-06-04">PR-VOTable-1.4.20190604</a>* <p> </p> |||
| <p>Duplication of words:</p> <pre>Page 11 . section 3.2, "...represents therefore a a valid name".</pre> <pre><pre>Page 22 section 5.2 "...a cell value flagged as null is filled with with the NaN value...".</pre> </pre> | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-May/001399.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5487" title="Revision 5487">5487</a> |
| <p>One other tiny doc bug; the schema has</p> <verbatim>      <xs:attribute name="timescale" use="required" type="xs:token">
        <xs:annotation>
          <xs:documentation>
            This is the time scale used.  Values SHOULD be
            taken from the IVOA timescale ( [[http://ivoa.net/rdf/timescale][http://ivoa.net/rdf/timescale]]).
          </xs:documentation>
        </xs:annotation>
      </xs:attribute>
</verbatim> <p>I think "IVOA timescale" should read "IVOA timescale vocabulary" (matching the wording for refposition).</p> | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5487" title="Revision 5487">5487</a> |
| <p>Fix vocabulary URLs to use www.ivoa.net. <span style="background-color: transparent;">(rather than ivoa.net; this follows the pattern set by Datalink and VOResource)</span></p> | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5406" title="Revision 5406">5406</a> |
| <p> </p> *Between <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190318/" title="Working draft 1.4 2019-03-18">WD-VOTable-1.4.20190318</a> and <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190403/" title="Working draft 1.4 2019-04-03">WD-VOTable-1.4.20190403</a>* <p> </p> |||
| Deliver the document for publishing properly so that images show up the html version. | N/A | N/A |
| <p>Sec 7.1</p> <p> </p> <ul> <li>Change the RESOURCE element diagram to clarify the necessary position(s) of INFO children.</li> <li><span style="background-color: transparent;">Include a comment that in case of </span><span style="background-color: transparent;">any discrepancies between the schema and the diagram, the schema </span><span style="background-color: transparent;">is definitive.</span></li> </ul><p> </p> <p>Also added page break prior to section 1.4 so that architecture figure shows up somewhere near the relevant text.</p> <p> </p> | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001381.html">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5378" title="Revision 5378">5378</a> |
| <p>Sec 5:</p> <pre> &lt;INFO name="HISTORY"&gt;<br /> The very first Virtual Telescope observation made in 2002<br /> &lt;/INFO&gt; <br /> This is not legal - the value attribute<br /> (optional at VOTable 1.0 but mandatory since VOTable 1.1)<br /> is missing. It should read:<br /> &lt;INFO name="HISTORY"<br /> value="The very first Virtual Telescope observation made in 2002"/&gt;</pre> <pre>Also, the INFO needs to be moved to the top of the RESOURCE as required by the VOTable schema.</pre> | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001380.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5377" title="Revision 5377">5377</a> |
| <span style="color: #7a4707;">Sec 3:</span> <pre> "documents may include schemaLocation attribute" <br /> -&gt; "documents may include the schemaLocation attribute"<br /> (or "a" or "some" ...)<br />Sec 3.5:<br /> "A \elem{TIMESYS} element referenced via a ref attribute MUST..."<br /> -&gt; "A \elem{TIMESYS} element referenced via a \attr{ref} attribute MUST..."?<br />Sec 4.1, item concerning the ref attribute:<br /> "(reference to the GROUP attribute which specifies the coordinate frame)"<br /> -&gt; "(reference to the COOSYS attribute which specifies the coordinate frame)"<br /></pre> | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001380.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5367" title="Revision 5367">5367</a> |
| Remove (somewhat crudely) STC from figure 1, the architecture diagram. | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001380.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5368" title="Revision 5368">5368</a> |
| <p> </p> *Between <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190218/" title="Working draft 1.4 2019-02-18">WD-VOTable-1.4.20190218</a> and <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190318/" title="Working draft 1.4 2019-03-18">WD-VOTable-1.4.20190318</a>* <p> </p> |||
| Miscellaneous cleanup edits. | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001378.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5337" title="revision 5337">5337</a> |
| Remove unused namespace declarations from examples. | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001378.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5336" title="revision 5336">5336</a> |
| <p>Make footnotes visible in HTML <span style="background-color: transparent;">(already correct in PDF). </span></p> <p><span style="background-color: transparent;">Addressed by displaying those as hyperlinks in HTML version.</span></p> | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-March/001376.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5335" title="revision 5335">5335</a> |
| Require "ref" for uses of TIMESYS | <a target="_blank" href="http://mail.ivoa.net/pipermail/apps/2019-February/001335.html" title="email">email</a> | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5334" title="revision 5334">5334</a> |
| <p> </p> *Between <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190131/" title="Working draft 1.4 2-19-01-29">WD-VOTable-1.4.20190131</a> and <a target="_blank" href="http://www.ivoa.net/documents/VOTable/20190218/" title="Working draft 1.4 2019-02-18">WD-VOTable-1.4.20190218</a>* <p> </p> |||
| <p> </p> <p>Section 3.5: reword the sentence:</p> <p>The TIMESYS element defines such a time system and gives itself the identifies itself with ID="time frame".</p> <p>to</p> <p>In the example, the TIMESYS element describes that time system. The TIMESYS ID value just needs to be unique within the document so that it can be referenced by FIELDs or PARAMs.</p> | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5316" title="revision 5316">5316</a> |
| In the section 3.5 TIMESYS example, remove the ID values from the FIELDs since they are not used. | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5317" title="Rev 5317">5317</a> |
| <p> </p> <p>Section 3 reworked to clarify namespace and schema versioning.</p> | | <p> </p> <p><a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5319" title="Rev 5319">5319</a>, <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5315" title="Rev 5315">5315</a></p> |
| Replace the claimed REC status of the document with the appropriate Working Draft disclaimer from the <a target="_blank" href="http://www.ivoa.net/documents/DocStd/20170517/" title="Document Standards">Document Standards</a> appendix. | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5318" title="Rev 5318">5318</a> |
| In sections 4.3 and 4.4, add references to DALI and VOUnits respectively since those standards came about since the writing of VOTable 1.3. Also mention those resources in section 1.4. | | <a target="_blank" href="https://volute.g-vo.org/viewvc/volute?view=revision&revision=5320" title="Rev 5320">5320</a> |

<br />&lt;!--<br /> * Set ALLOWTOPICRENAME = IVOA.TWikiAdminGroup<br />--&gt;
Topic revision: r16 - 2019-06-03 - TomDonaldson
IVOA
Log in or Register
IVOA.net
Wiki Home
WebChanges
WebTopicList
WebStatistics
Twiki Meta & Help
IVOA
Know
Main
Sandbox
TWiki
TWiki intro
TWiki tutorial
User registration
Notify me
Working Groups
Interest Groups
Committees
Stds&Procs
www.ivoa.net
Documents
Events
Members
XML Schema