TAPRegExt erratum, Identifiers for Obscore

Robert J. Hanisch hanisch at stsci.edu
Wed Dec 11 06:40:42 PST 2013



On 12/11/13 5:01 AM, "Mark Taylor" <m.b.taylor at bristol.ac.uk> wrote:

>Bob,
>
>On Tue, 10 Dec 2013, Robert J. Hanisch wrote:
>
>> I think it would be more consistent with the versioning system we have
>> been using for nearly 10 years to make an incremental (0.01 delta)
>>release
>> of the document, note the errors that have been corrected in the change
>> log, and fix the problem in the main document.  If people don't bother
>>to
>> look at the change log / erratum they will go on implementing the wrong
>> thing.
>
>I think what you suggest would be more consistent with the versioning
>system used for the first few years of the IVOA, (e.g. VOSpace 1.15,
>2009),
>but not with the one that's been in force since DocStd 1.2 in 2010
>(e.g. VOSpace 2.0, 2013).  Document numbers are now, at in least all
>cases to date, a.b where a and b are single digits.  DocStd 1.2
>ditched the idea of characterising small changes in content by
>changes to the version number.

I stand corrected -- and I should have remembered this update, since I
edited the document.

> 
>> It was never the intention to make it onerous to fix minor problems with
>> documents.
>> 
>> If the WG Chair advises the TCG chair and IVOA chair that the nature of
>> the change is that of a correction, repair of a typo, etc., there would
>>be
>> no need to go through the full-up review and sign-off process.
>>
>> Bob
>
>I don't recall any historical precedent for this short cut process,
>and I don't see any reference to it in the DocStd document.

No there isn't, but there should be.
>
>> On 12/10/13 2:23 PM, "Patrick Dowler" <patrick.dowler at nrc-cnrc.gc.ca>
>> wrote:
>> 
>> >
>> >In my opinion, I think that the editor(s) and WD chair+vice-chair
>>should
>> >be able to add Errata to the end of a document and republish it to the
>> >repository with the same version number. The date on the title page
>> >probably has to remain unchanged as that is the date it was
>>recommended,
>> >so a secondary date might need to be added to the title page of the
>> >document if/when errata are added/modified.
>> >
>> >Errata would never change the text of the document -- only a section at
>> >the end (after Changes, before References).
>> >
>> >Thoughts? I can bring this up at the next TCG telecon to determine a
>> >path forward, but I don't think this would have any technical hurdles.
>> >
>> >Pat
>
>Personally I prefer the idea of a separate errata document accessible
>from the document landing page, as Markus suggests, over either Bob's
>or Pat's suggestions.  However, I think this is something that we need
>to discuss in the TCG: both whether it's necessary/desirable at all,
>and if so the details of how to do it.
>
>Mark

I still worry about errata and the document they refer to becoming
separated.

Bob

>
>--
>Mark Taylor   Astronomical Programmer   Physics, Bristol University, UK
>m.b.taylor at bris.ac.uk +44-117-9288776  http://www.star.bris.ac.uk/~mbt/



More information about the dm mailing list