search

cern-sis / issues-inspire

0 stars 0 forks source link

author.xml mismatch between docs and DTD for `cal:authorCollaboration` #461

Open michamos opened 3 months ago

michamos commented 3 months ago

A user reports in a ticket:

I am having difficulty with an author.xml file failing the xmllint test (using author.dtd) for an author with two collaborations. See EXAMPLE at the end of this message.

In your README file at github.com/inspirehep/author.xml?tab=readme-ov-file#getauthordtd , the element has the required element and it says "If the author is a member of more than one collaborations or has more than one position, THIS ELEMENT MAY BE REPEATED.” [my emphasis]

But the author.dtd file allows only one element for element ; if I put two, xmllint prints an error.

However, if I change cal:authorCollaboration? to cal:authorCollaboration+ in the definition in author.dtd, then xmllint works without error. With this change, it seems to be like the intended behaviour described in the README file linked above.

We should align the docs with the DTD or vice-versa.