W3C home > Mailing lists > Public > public-grddl-wg@w3.org > May 2007

review of namespace doc

From: Jeremy Carroll <jjc@hpl.hp.com>
Date: Thu, 24 May 2007 14:48:54 +0100
Message-ID: <465597C6.2060801@hpl.hp.com>
To: GRDDL Working Group <public-grddl-wg@w3.org>


Summary:

Much better than when I last looked, still a little bit of tidy up 
needed before PR.

=============

This is a review of:

http://www.w3.org/2003/g/data-view
$Revision: 1.41 $ of $Date: 2007/05/02 13:33:23 $
      by $Author: connolly $


1)
The document should link to the specification in the first para.

2)
Before PR the Note:
[[
Note: While we have a growing
       body of documentation, examples, code,
       and experience with GRDDL, it is still experimental and subject
       to changes.  The GRDDL Working
       Group welcomes comments
       by email.
]]
should be rewritten.

3)
Suggest the heading:
[[
Learning More
]]
should be
[[
Definition of the GRDDL Namespace and Metadata Profile
]]

4) in the first reference
Suggest delete "2
         March 2007"
the link is an undated URL and so the text should not have a date either.
The undated version seems appropriate.
(On looking at the GRDDL result, I am unsure about this comment.
Overall, the conventions on dated versus undated versions are not 
entirely clear).


5) Before PR, I suggest deleting the ToDo item at the bottom of the 
page, either by doing it, or by not doing it.


6) Reading the GRDDL namespace with the Jena reader ...
(this looks OK, but perhaps should be reviewed in detail)

<rdf:RDF
     xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
     xmlns:j.0="http://xmlns.com/foaf/0.1/"
     xmlns="http://usefulinc.com/ns/doap#"
     xmlns:owl="http://www.w3.org/2002/07/owl#"
     xmlns:j.1="http://purl.org/dc/elements/1.1/"
     xmlns:admin="http://webns.net/mvcb/"
     xmlns:j.2="http://www.rddl.org/purposes#"
     xmlns:j.3="http://www.w3.org/2000/01/rdf-schema#">
   <rdf:Description rdf:about="">
     <j.2:normative-reference>
       <rdf:Description rdf:about="/TR/rdf-concepts/">
         <j.1:date>2004-02-10</j.1:date>
         <j.1:title>Resource
       Description Framework (RDF): Concepts and Abstract
       Syntax</j.1:title>
         <j.3:label>Resource
       Description Framework (RDF): Concepts and Abstract
       Syntax, 10
       February 2004</j.3:label>
       </rdf:Description>
     </j.2:normative-reference>
     <j.2:normative-reference>
       <rdf:Description rdf:about="/TR/xslt">
         <j.3:label>XSLT</j.3:label>
       </rdf:Description>
     </j.2:normative-reference>
     <j.2:normative-reference>
       <rdf:Description rdf:about="/TR/grddl/">
         <j.1:date>2007-03-02</j.1:date>
         <j.1:title>Gleaning
         Resource Descriptions from Dialects of Languages
         (GRDDL)</j.1:title>
         <j.3:label>Gleaning
         Resource Descriptions from Dialects of Languages
         (GRDDL), 2
         March 2007</j.3:label>
       </rdf:Description>
     </j.2:normative-reference>
     <j.0:maker>
       <rdf:Description rdf:ID="grddl-wg">
         <j.0:homepage>
           <rdf:Description rdf:about="/2001/sw-grddl-wg/">
             <j.3:label>the GRDDL Working Group</j.3:label>
           </rdf:Description>
         </j.0:homepage>
       </rdf:Description>
     </j.0:maker>
     <admin:generatorAgent rdf:resource="http://purl.org/NET/erdf/extract"/>
   </rdf:Description>
   <j.3:Class rdf:ID="TransformationProperty">
     <j.3:range>
       <j.3:Class rdf:ID="RDFGraph"/>
     </j.3:range>
     <j.3:domain>
       <j.3:Class rdf:ID="RootNode"/>
     </j.3:domain>
     <j.3:subClassOf>
       <rdf:Description rdf:about="/2002/07/owl#FunctionalProperty">
         <j.3:label>FunctionalProperty</j.3:label>
       </rdf:Description>
     </j.3:subClassOf>
     <j.3:comment>a FunctionalProperty that relates
     XML document root nodes to
     RDF graphs</j.3:comment>
     <j.3:label>TransformationProperty</j.3:label>
   </j.3:Class>
   <j.3:Class rdf:about="#RDFGraph">
     <j.3:isDefinedBy>
       <rdf:Description 
rdf:about="/TR/2004/REC-rdf-concepts-20040210/#dfn-rdf-graph">
         <j.3:label>definition
     in Resource Description Framework (RDF): Concepts and
     Abstract Syntax</j.3:label>
       </rdf:Description>
     </j.3:isDefinedBy>
     <j.3:comment>a
     set of RDF triples</j.3:comment>
     <j.3:label>RDF graphs</j.3:label>
     <j.3:label>RDFGraph</j.3:label>
   </j.3:Class>
   <j.3:Class rdf:about="#RootNode">
     <j.3:isDefinedBy>
       <rdf:Description rdf:about="/TR/1999/REC-xpath-19991116#root-node">
         <j.3:label>section
     5.1 Root Node in XML Path Language (XPath) Version
     1.0</j.3:label>
       </rdf:Description>
     </j.3:isDefinedBy>
     <j.3:comment>the root of the tree in the XPath data
     model</j.3:comment>
     <j.3:label>XML document root nodes</j.3:label>
     <j.3:label>RootNode</j.3:label>
   </j.3:Class>
   <j.3:Class rdf:ID="Transformation">
     <owl:someValuesFrom rdf:resource="#TransformationProperty"/>
     <owl:onProperty>
       <owl:FunctionalProperty rdf:ID="transformationProperty"/>
     </owl:onProperty>
     <j.3:subClassOf>
       <j.3:Class rdf:ID="InformationResource"/>
     </j.3:subClassOf>
     <j.3:comment>an InformationResource that specifies
     a transformation from a set of XML documents to RDF 
graphs</j.3:comment>
     <j.3:label>Transformation</j.3:label>
   </j.3:Class>
   <j.3:Class rdf:about="#InformationResource">
     <j.3:isDefinedBy>
       <rdf:Description 
rdf:about="/TR/2004/REC-webarch-20041215/#def-information-resource">
         <j.3:label>definition in Architecture of the World Wide Web, 
Volume One</j.3:label>
       </rdf:Description>
     </j.3:isDefinedBy>
     <j.3:comment>A resource which has the property that all of its 
essential characteristics can be conveyed in a message</j.3:comment>
     <j.3:label>InformationResource</j.3:label>
   </j.3:Class>
   <rdf:Property rdf:ID="profileTransformation">
     <j.3:range rdf:resource="#Transformation"/>
     <j.3:comment>relates a profile document to a
     transformation for all documents bearing that profile</j.3:comment>
     <j.3:label>profileTransformation</j.3:label>
   </rdf:Property>
   <rdf:Property rdf:ID="transformation">
     <j.3:range rdf:resource="#Transformation"/>
     <j.3:domain rdf:resource="#RootNode"/>
     <j.3:comment>relates a source document to a
     transformation, usually represented in XSLT, that relates the 
source document syntax
     to the RDF graph syntax</j.3:comment>
     <j.3:label>transformation</j.3:label>
   </rdf:Property>
   <rdf:Property rdf:ID="result">
     <j.3:range rdf:resource="#RDFGraph"/>
     <j.3:domain rdf:resource="#InformationResource"/>
     <j.3:comment>an
     RDF graph obtained from an information resource by directly
     parsing a representation in the standard RDF/XML syntax or
     indirectly by parsing some other dialect using a transformation
     nominated by the document</j.3:comment>
     <j.3:label>result</j.3:label>
   </rdf:Property>
   <rdf:Property rdf:ID="namespaceTransformation">
     <j.3:range rdf:resource="#Transformation"/>
     <j.3:comment>relates a namespace to a transformation for
     all documents in that namespace</j.3:comment>
     <j.3:label>namespaceTransformation</j.3:label>
   </rdf:Property>
   <owl:FunctionalProperty rdf:about="#transformationProperty">
     <j.3:range rdf:resource="#TransformationProperty"/>
     <j.3:domain rdf:resource="#Transformation"/>
     <j.3:comment>relates a transformation to the algorithm
     specified by the property that computes an RDF graph from an XML
     document node</j.3:comment>
     <j.3:label>transformationProperty</j.3:label>
   </owl:FunctionalProperty>
   <rdf:Description rdf:ID="grddlProject">
     <homepage rdf:resource=""/>
     <mailing-list>
       <rdf:Description 
rdf:about="http://lists.w3.org/Archives/Public/public-grddl-comments/">
         <j.3:label>public-grddl-comments</j.3:label>
       </rdf:Description>
     </mailing-list>
     <shortdesc>GRDDL
     is a technique for gleaning resource
     descriptions from dialects of
     languages. It's a way of extracting Semantic Web
     data in RDF from XML formats (especially
     XHTML dialects or microformats) via
     transformations identified by URIs and typically expressed in
     XSLT.</shortdesc>
   </rdf:Description>
   <rdf:Description rdf:ID="danc">
     <j.0:homepage>
       <rdf:Description rdf:about="/People/Connolly/">
         <j.3:label>Dan Connolly</j.3:label>
       </rdf:Description>
     </j.0:homepage>
     <j.0:name>Dan Connolly</j.0:name>
   </rdf:Description>
</rdf:RDF>


-- 
Hewlett-Packard Limited
registered Office: Cain Road, Bracknell, Berks RG12 1HN
Registered No: 690597 England
Received on Thursday, 24 May 2007 13:49:31 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:11:49 GMT