When I recently read RDF/XML, I find two places that can be made more clear.
Their meaning are obvious to people familiar with RDF, but not to the RDF
beginner.
1)
{{ the third paragraph in 2.1.4 Abbreviating URIs: rdf:ID and xml:base
Both forms require a base URI ___to be known___, either from an in-scope
xml:base or from the URI of the RDF/XML document.
}}
When and who is required to know the base URI is not clear in the context.
2)
{{ the first paragraph in 2.16 Collections: rdf:parseType="Collection"
RDF/XML allows an rdf:parseType="Collection" attribute on a property element
to let it contain multiple node elements. These contained node elements give
the set of subject nodes of the collection. This syntax form corresponds to
a set of triples connecting the collection of ____subject nodes____, the
exact triples generated are described in detail in Section 7.2.19 Production
parseTypeCollectionPropertyElt. The collection construction is always done
in the order that the node elements appear in the XML document. Whether the
order of the collection of nodes is significant is an application issue and
not defined here.
}}
The "subject nodes" here tends to be misleading.
Cheers,
Collin