- From: Frank Manola <fmanola@acm.org>
- Date: Mon, 23 Jan 2006 15:42:09 -0500
- To: Ben Adida <ben@mit.edu>
- CC: SWBPD list <public-swbp-wg@w3.org>
Ben Adida wrote: > > Guus and team, > > Happy New Year! > > Please find the latest version of the RDF/A Primer at: > http://www.w3.org/2001/sw/BestPractices/HTML/2006-01-15-rdfa-primer > A few quick comments on the RDF/A Primer: 1. Overall, a very nice job! 2. It seems to me that "property" is used in a way which differs slightly from its use in both the RDF/A syntax document and RDF Concepts, and hence which is potentially confusing. For example, Section 3.1 starts "A literal property is a string of text, e.g., 'Ben Adida', ..." But in both the syntax document and RDF Concepts, "property" refers to something like "dc:creator" (e.g., the value of an RDF/A "property" attribute), and "Ben Adida" would be the *value* of this property (in a specific triple). Hence it seems to me that Section 3.1 should describe "Literal-Valued Properties" (and the intro would need to be changed), and Section 3.2 should describe "URI-Valued Properties". (You might want to start out by saying what a "property" is). On this same subject, it might be worthwhile to consider pointing out that properties and their values as discussed here are similar in many respects to the name and content attributes in meta tags that are already part of HTML. The HTML spec makes the same distinction I've made above, describing the "name" attribute as identifying a property name, while "content" specifies a property value. 3. Also in Section 3.1, the example that illustrates that the <span> element is not required: <h1 property="dc:title">Vacation in the South of France</h1> <h2>created by <span property="dc:creator">Mark Birbeck</span></h2> still uses the <span> element in the second line, and it might be a clearer illustration that <span> is not required if *neither* line used <span>. 4. It seems to me that the Bibliography should include a reference to the RDF/A syntax document. --Frank
Received on Monday, 23 January 2006 20:40:30 UTC