RDFa 1.1 API Comments

Hello all,

I've noticed that that RDFa 1.1 API document is in somewhat of an
undetermined state.  I just spent time working on an implementation
within the browser and I have some issues/comments I'd like make you
all aware of regardless of where that document ends up.

Here are my issues:

1. In 3.6, RDFaEnvironment, the key values in the query should be
resolved as CURIE values.  This is not specified in the description.
Otherwise, the examples in the document do not work.

2. The term "default document mapping" is used without being defined.

3. How CURIEs are resolved against any mapping is not defined.  Once
could assume that the default document mapping is merged with those
set programmatically via setMapping() but this needs to be clarified.

4. It is unclear whether Document.getElementsByProperty should return
the subject origin, the predicate origin, or the value origin.  I
suggest the value origin.

5. A CURIE value should be allowed on Document.getElementsByProperty().

6. Document.getElementsByProperty() returns a NodeList of elements
that exhibit a property (predicate).  How does one use the API to
enumerate that list of elements and get each "property value"?

7. When constructing a Projection instance from a template, if a
property has multiple values, is the object property set to the first
value or the array of values?

8. How is "first property" defined for Projection.get() given the
sequence algorithm of RDFa 1.1?


-- 
--Alex Milowski
"The excellence of grammar as a guide is proportional to the paucity of the
inflexions, i.e. to the degree of analysis effected by the language
considered."

Bertrand Russell in a footnote of Principles of Mathematics

Received on Tuesday, 6 March 2012 00:19:29 UTC