About UCD1+ 1.4 upcoming EN

Markus Demleitner msdemlei at ari.uni-heidelberg.de
Sat Oct 12 21:53:50 CEST 2019


Baptiste,

On Fri, Oct 11, 2019 at 09:58:20AM +0200, Baptiste Cecconi wrote:
> I just went through the IVOA document repository page
> (http://www.ivoa.net/documents/ <http://www.ivoa.net/documents/>),
> and it appeared to me that the proposed path for UCD1+ update
> (through EN) may lead to strange effect:
> 
> In the "Technical Specifications" section / "Semantics", the
> Technical specification displays version 1.3 of UCD1+
> specification, and this should stay this way, even after the EN is
> out. The "Endorsed Note" section is below the "Technical
> Specifications" one. So the new UCD1+ version to be used is not the
> one a (in)experienced user will find first on that page. 

I agree that is certainly a problem.  I guess as part of the
endorsement process of the UCD list EN in the TCG we should propose
to retire the UCD1+ REC and move it into the Obsolete IVOA documents
section, which would happen "atomically" with the adoption of the EN.
That way, people will at least first encounter the new EN; I don't
think we can entirely hide the existing REC.

I'd also suggest that on the landing page of the REC, i.e., 
http://www.ivoa.net/documents/UCD1+, we post a link to the EN, somewhat
like "This document has been deprecated by (link)UCD maintenance 2.0.
Please refer to (link)the most recent UCD list EN".

I don't think we have much prior art for having a clear and unique
successor to a retiring document, so I suppose we will have to work
out a smart way to deal with it -- I'm cc-ing docstd in case someone
over there wants to chime in.

Mireille -- do you roughly consent to that approach or do you have a
different plan?  And Baptiste, if you push forward the PEN, would you
mention this plan to the TCG?

        -- Markus


More information about the semantics mailing list