Primer suggestions - especially to have namespace transformation example

A couple of primer suggestions:

1. For people who merely want to use GRDDL, I think it would be helpful
in the Primer introduction to summarize the available mechanisms for
indicating GRDDL transformations, and indicate which primer section
demonstrates that mechanism.  Even better would be for this summary to
also act as a complete crib sheet, showing the actual snippet of what is
needed, so that users could easily refer back to it as a reminder.  Here
is suggested text along the lines of what I mean:
[[
There are four ways an XML document can indicate GRDDL transformations:

 - Set the grddl:transformation attribute on the root element (see
section @@@@).  Example:
	@@example@@

 - Specify transformations in the root element namespace document (see
section @@@@).  Example:
	@@example@@

 - (XHTML only) Use the GRDDL metadata profile and specify
transformations in <link> or <a> elements (see section @@@@).  Example:
	@@example@@

 - (XHTML only) Specify transformations in a metadata profile document
(see section @@@@).  Example:
	@@example@@
]]

2. I think it is important that we do have an example of namespace
transformations in the primer.  It may be possible to change the Health
Care example to use namespace transformations:
http://www.w3.org/2001/sw/grddl-wg/doc29/primer.html#hl7
However, I notice that the root namespace is a URN instead of an http
URI. :(  Would it be a problem to wrap the <clinicalDocument> element
inside a new root element with a different namespace?  Do others have
other ideas?  My main concern is that I think it's important to
illustrate each of the four GRDDL mechanisms.


David Booth, Ph.D.
HP Software
+1 617 629 8881 office  |  dbooth@hp.com
http://www.hp.com/go/software

Opinions expressed herein are those of the author and do not represent
the official views of HP unless explicitly stated otherwise.

Received on Monday, 25 June 2007 03:53:45 UTC