[Ops] New IVOA Validation Page

Tom McGlynn (NASA/GSFC Code 660.1) tom.mcglynn at nasa.gov
Tue Apr 19 15:51:34 CEST 2016


Presumably it would not be very hard to contemplate multiple ways of 
rendering the underlying information with the data saved as XML and 
different stylesheets to render it in a tabular or hierarchical or ... 
fashion.  However I suspect that way lies madness.

I think your style would be fine.  I was deliberately mimicking the 
table we use for the standards documents which I thought that would make 
it easy for a person looking for validators to find the correct one.  
 From the perspective of the IVOA it would also give a clearer sense of 
the coverage of validators for the IVOA standards.

What if we were to replace your table of contents with a real table 
which has the same rows as the standards table, includes a column which 
indicates the status of  validators for that standard, but points to 
text below for the descriptions and URL? That would give us both the 
view of how we're doing but not squeeze long descriptions into the 
table.   So we'd just have WG, Standard name, versions? and validator 
status in the table so we'd  get a  compact table highlighting where we 
have good validator coverage and where work is needed.

I considered whether we might want to add another column to the existing 
standards table, but I'd be concerned that it's too difficult to change 
that table.  Having the validator page on the wiki makes it more 
flexible.  However we will want a link from the standards page to the 
validator page.

     Tom




Mark Taylor wrote:
> Tom & ops,
>
> concerning the format of the IvoaValidatorsSummary page:
> it's a bit hard to flatten this kind of structured information
> into a table (e.g. some rows of the table represent WGs, some
> standards and some validators, so entries in a given column
> are not always directly comparable).
>
> Just to see what it looks like, I've had a go at representing
> (some of) the same information in a more hierarchical/document-like
> twiki page.  You can see the results here:
>
>     http://wiki.ivoa.net/twiki/bin/view/Sandbox/MarkTaylorSandboxValidators
>
> I'm not sure if it's an improvement or not.
>
> Pros:
>     - can link to an entry for a particular standard from outside the page
>     - easier to navigate (from TOC)
>     - more space available for detailed descriptions (where required)
>     - more flexible
>
> Cons:
>     - less compact
>     - harder to compare entries by eye, e.g., versions supported by
>       different validators or validator availability status for
>       different standards
>
> Others may have opinions on which presentation is more useful.
> If you/others prefer the tabular format - that's fine by me.
>
> I have some content to add for some of the standards (at least SAMP,
> VOTable; also taplint contributions to UWS, ObsCore, TAPRegExt and maybe
> others), I'll do that in due course.
>
> Mark
>
> On Mon, 18 Apr 2016, Tom McGlynn (NASA/GSFC Code 660.1) wrote:
>
>> During the last TCG telecon I volunteered to help put up a page providing an
>> introduction and summary of all validation capabilities associated with IVOA
>> standards. I've begun this effort at
>> http://wiki.ivoa.net/twiki/bin/view/IVOA/IvoaValidatorsSummary where my plan
>> would be to ultimately mirror the IVOA standards page with an entry for every
>> standard -- there's a long way to go.  There will be a talk on this at Cape
>> Town, but I'd certainly be interested in comments earlier or from those who
>> are not attending.
>>   I've sent out this original note generally, but I'd suggest responses on the
>> Ops list.  Feel free to comment on the format, arrangement and such as well as
>> the content.  What would make this most useful to the IVOA and our
>> constituents?
>>
>> I would be <very> appreciative of people responsible for various validation
>> capabilities adding to or revising the current entries.
>>
>>      Regards,
>>      Tom McGlynn
>>
>>
> --
> 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/
> _______________________________________________
> ops mailing list
> ops at ivoa.net
> http://mail.ivoa.net/mailman/listinfo/ops



More information about the ops mailing list