Schema documentation comments

[geo-mac]

An issue thread for any RGG comments arising from the 28 April 2023 documentation.

[paulwalk]

I continue to have real misgivings about the use of <dc:creator> inside <rioxxterms:author>.

For example:

<rioxxterms:author>
    <dc:creator>Mannion, O. M.</dc:creator>
    <dc:identifier>https://orcid.org/0000-0001-8029-5109</dc:identifier>
</rioxxterms:author>

Semantically, this is saying that Mannion, O. M. is the creator of an author!

It is actually perfectly permissible in XML to have this instead:

<rioxxterms:author>
    Mannion, O. M.
    <dc:identifier>https://orcid.org/0000-0001-8029-5109</dc:identifier>
</rioxxterms:author>

which is semantically clear.

I recommend that we do it this way - simple and clear!

[geo-mac]

As we discussed at the meeting, dc:creator nested inside rioxxterms:author appears odd.

However, "this is the creator of an author" only applies if we use Rioxx v2 semantics. I have updated the schema docs to change the semantics of rioxxterms:author, making it a 'container of attribution data' -- which I have just published and will share over email imminently! In this context both dc:creator and dc:identifier make more semantic sense. Have a look at this and see what you think. An XML complex type could be, well, too complex! ;-)