- From: Ivan Herman <ivan@w3.org>
- Date: Tue, 17 Jan 2012 13:20:13 +0100
- To: W3C RDFWA WG <public-rdfa-wg@w3.org>, Manu Sporny <msporny@digitalbazaar.com>
- Message-Id: <6A0A211C-A313-45AA-B17F-EA6D06C2A249@w3.org>
Note that my comments would lead to a slightly more substantial rewrite of section 3. I am happy to review this text after it has changed. Ivan 1. Introduction I do not think the sentence [[[ The RDFa syntax [RDFA-CORE] is often criticized as having too much functionality, leaving first-time authors confused about the more advanced features. This lighter version of RDFa helps authors easily jump into the structured data world. The goal was to create a very minimal subset that will work for 80% of the folks out there doing simple data markup. ]]] is appropriate and good in a Rec. Something like that might be better for the full paragraph: [[[ The RDFa syntax [RDFA-CORE] provides a rich functionality making it possible to represent fairly complex structures (essentially any RDF graph) in an HTML or XML content. However, that complexity may make it difficult for authors, who may not be experts in structured data, to use RDFa. This lighter version of RDFa helps authors to start using the structured data world more easily. The goal is to provide a minimal subset that will work for 80% of authors doing simple data markup. ]]] 2.1. vocab, typeof and property "which is specify which vocabulary that we are going to be using" -> "which is to specify which vocabulary we are going to be using" 2.2. about " using a unique Uniform Resource Locator (URL)" we had the issue on the usage of URI vs. URL. We should have a consistency across document which, in this case, I believe would mean to use URI-s. The document should be checked for the URL/URI issue overall. 2.3 prefix In the example: maybe my zoological knowledge is poor, but is there such an animal as 'Liger'? Or did you mean 'Tiger'? Also: why using the <a> element for the (T|L)iger? I think a <span> would be more appropriate. 2. (General comment) - An attentive reader of RDFa 1.1 Core might realize that, in all places, a full URI can be used. Ie, @vocab is not the _only_ way of doing things. It may be worth noting that and adding an example on that in the section (with a special attention to those who want to see only full URI-s). - It may also be worth adding an example where more than one type is used for an entity, possibly with one being specified via a full URI. THis is one of the features that is difficult to express in microdata... - I wonder how to express that in the document... The examples are deliberately simple. Misleadingly so, in fact... using RDFa Lite, more complex structures can be expressed and the reader may *think* that those are not 'legal'. (Eg, @property based chaining with @typeof is possible) One way of doing that would be declare the whole of section 2 as informative, and make a reference to the Primer for further examples. We could then review the primer (we have time for that) to make it much more explicit about Lite or not Lite. That would leave section 3 as being THE normative section, which probably means that allowed RDFa Lite attributes should be explicitly listed there, too. 3. Conformance Both 3.1 and 3.2 talks about HTML+RDFa Lite only. I believe RDFa Lite should be defined for any language, there is no reason to restrict it to HTML. Ie, the section needs some editing in which: - conformance is defined in terms of RDFa Core - there may be a remark saying that all language profiles automatically inherit the conformance on Lite, so to say The current text would lead to admin problems, too. By referring to HTML-RDFa normatively we would have to stop the recommendation until HTML-RDFa becomes a Rec which depends on when HTML5 becomes are rec... By referring, normatively, to RDFa Core we avoid such issues. References - HTML-RDFa should also be marked as work in progress - Why would RDFa Core be an informative reference? ---- Ivan Herman, W3C Semantic Web Activity Lead Home: http://www.w3.org/People/Ivan/ mobile: +31-641044153 FOAF: http://www.ivan-herman.net/foaf.rdf
Attachments
- application/pkcs7-signature attachment: smime.p7s
Received on Tuesday, 17 January 2012 12:19:15 UTC