Schema repo presentation

[Markus Demleitner]

Hi Mark,

On Mon, Mar 15, 2021 at 01:27:55PM +0000, Mark Taylor wrote:
>   - The namespace applies to some, though not all, of the versions
>     listed in the entry it appears near to.  Your example lists:
> 
>        VOEvent: v2.0 v1.1 v1.0 		  	 
>        Target Namespace: http://www.ivoa.net/xml/VOEvent/v2.0

Yes, I admit I've not thought of pre-schema versioning schemas.  I
give you this isn't going to help at all.

So, scratch my original idea.

>   - Or maybe just add a banner at the top of the table saying
>     "Be careful of namespaces - see the XMLVers document for details"

I guess that's what we ought to do then.  Here's some HTML that we
could put just below the "XML Schema" header.

  <p class="admonition">Note that schema versions and their target
  namespace are largely decoupled as per our 
  <a href="/documents/Notes/XMLVers">Schema versioning policies</a>.
  For instance, the schema UWS-<strong>v1.1</strong>.xsd has the
  target namespace http://www.ivoa.net/xml/UWS/<strong>v1.0</strong>
  (and will be returned if you dereference that).  Always inspect the
  targetNamespace attribute on the root element of the schema.</p>

Thanks,

         Markus