<div dir="ltr">Hi Mark,<div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 11, 2016 at 6:47 AM, Mark Taylor <span dir="ltr"><<a href="mailto:M.B.Taylor@bristol.ac.uk" target="_blank">M.B.Taylor@bristol.ac.uk</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Brian,<br>
<span class=""><br>
On Tue, 5 Jul 2016, Brian Major wrote:<br>
<br>
> I've made a revision to the document to clarify the role of the detail<br>
> parameter based on our conversations in Stellenbosch. Essentially, the<br>
> presence of the detail parameter with a value of 'min' or 'max' is a<br>
> suggestion to the service as to what level of table detail to provide (with<br>
> or without Column and ForeignKey elements), but the service may choose<br>
> whichever. If the detail parameter is not provided, the service may again<br>
> choose whichever level of detail. This ensures full backwards<br>
> compatibility with 1.0 and allows services with a lot of table metadata to<br>
> always return the minimum level of detail.<br>
<br>
</span>thanks, this looks about right and I think it will be a helpful<br>
change for my TAP clients.</blockquote><div><br></div><div>Good!</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I have one suggestion for the text.<br>
Currently it says:<br>
<br>
The child resource must be named with the fully-qualified table<br>
name and without any intervening schema name. For example:<br>
<br>
\begin{verbatim}<br>
GET <a href="http://example.net/srv/tables/ivoa.ObsCore" rel="noreferrer" target="_blank">http://example.net/srv/tables/ivoa.ObsCore</a><br>
\end{verbatim}<br>
<span class=""><br>
would return a Table document describing the ivoa.ObsCore table<br>
</span> in full detail.<br>
<br>
That is correct, but I find it slightly confusing (since in this<br>
example the schema name "ivoa" is present, but not in virtue of the<br>
schema/table hierarchy).</blockquote><div><br></div><div>Okay, yes, I can see how that could be confusing.<br> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I would suggest instead:<br>
<br>
The child resource must be named with the fully-qualified table name,<br>
as it appears in the name child of the corresponding Table element.<br></blockquote><div><br></div><div>I think we need to be more concrete (more than just the example) on how services must name their tables. It would be nice if clients were able to discover individual tables intuitively (i.e., by naming convention) without first going to the full document at /tables to find out what the service named them.</div><div><br></div><div>Perhaps, instead of saying 'without database schema', we could say that a fully qualified table name is in the format: <database>.<table-name><br><br>Or, we could change the example to avoid confusion...</div><div> <br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
For example:<br>
<br>
\begin{verbatim}<br>
GET <a href="http://example.net/srv/tables/ivoa.ObsCore" rel="noreferrer" target="_blank">http://example.net/srv/tables/ivoa.ObsCore</a><br>
\end{verbatim}<br>
<span class=""><br>
would return a Table document describing the ivoa.ObsCore table<br>
</span> in full detail, starting:<br>
<br>
\begin{verbatim}<br>
<vosi:table xmlns:vosi="<a href="http://www.ivoa.net/xml/VOSITables/v1.0" rel="noreferrer" target="_blank">http://www.ivoa.net/xml/VOSITables/v1.0</a>"><br>
<name>ivoa.ObsCore</name><br>
<column><br>
...<br>
\end{verbatim}<br>
<span class="HOEnZb"><font color="#888888"><br>
Mark<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
--<br>
Mark Taylor Astronomical Programmer Physics, Bristol University, UK<br>
<a href="mailto:m.b.taylor@bris.ac.uk">m.b.taylor@bris.ac.uk</a> <a href="tel:%2B44-117-9288776" value="+441179288776">+44-117-9288776</a> <a href="http://www.star.bris.ac.uk/~mbt/" rel="noreferrer" target="_blank">http://www.star.bris.ac.uk/~mbt/</a><br>
</div></div></blockquote></div><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">Cheers,</div><div class="gmail_extra">Brian</div><div class="gmail_extra"><br></div></div>