zimeon / www.openarchives.org

Content for the http://www.openarchives.org/ website
3 stars 0 forks source link

Criteria -> Criterion in OAI-PMH, add example character reference #14

Open zimeon opened 7 years ago

zimeon commented 7 years ago

On 4/28/17 8:53 AM, John O'Hanley wrote:

Hello,

Re: http://www.openarchives.org/OAI/openarchivesprotocol.html

1. Typo, should be 'criterion': /"Harvesters may specify set membership as a criteria for selective harvesting."/ /"Therefore, a harvester should not assume that the members in an incomplete list conform to some selection criteria (e.g., date ordering)."/

Indeed, criterion is the singular.

2. /"Character references, rather than entity references, must be used."/ In this context, note that the W3C calls these /'character entity references'/, if I'm not mistaken. If that's the correct term, then the above statement in the protocol spec makes no sense. https://www.w3.org/TR/html4/sgml/entities.html -- numbers only https://dev.w3.org/html5/html-author/charref (note the HTML title of the page)

The context here is XML rather than HTML and it seems that these different W3C specs are inconsistent in terminology for character (entity) references. In XML it is just "character reference":

https://www.w3.org/TR/2006/REC-xml11-20060816/#sec-references

I gather that what's meant is that you need to use the numeric form, for example 'ñ' , not 'ñ '

The ambiguity would be resolved by providing a single example.

That would have been a good idea.

Cheers, Simeon

Regards, John O'Hanley