The names in a namespace form a collection. Sometimes it is a collection of element names (DocBook and XHTML, for example), sometimes it is a collection of attribute names (XLink, for example), sometimes it is a collection of functions (XQuery 1.0 and XPath 2.0 Data Model), sometimes it is a collection of properties (FOAF), sometimes it is a collection of concepts (WordNet). The names in a namespace can, in theory at least, be defined to identify any thing or any number of things.

Given the wide variety of things that can be identified, it follows that an equally wide variety of ancillary resources may be relevant to a namespace. A namespace may have documentation (specifications, reference material, tutorials, etc., perhaps in several formats and several languages), schemas (in any of several forms), stylesheets, software libraries, applications, or any other kind of related resource.

A user, encountering a namespace “in the wild” might want to find any or all of these related resources. In the absence of any other information, a logical place to look for these resources, or information about them, is at the location of the namespace URI itself.

says that it is a Good Practice for the owner of a namespace to make available at the namespace URI “material intended for people to read and material optimized for software agents in order to meet the needs of those who will use the namespace”.

The question remains, how can we best provide both human and machine readable information at the namespace URI such that we can achieve the good practice identified by web architecture? One early attempt was . RDDL 1.0 is an XLink-based vocabulary for identifying the nature and purpose of related resources.

Several attempts were made to simplify RDDL. The TAG's original plan for addressing namespaceDocument-8 was to help define a simpler, standard RDDL format. However, time has passed, RDDL 1.0 is now widely deployed. In addition, some of the proposed alternative formats are also deployed. And it seems likely that over time new variations may arise based on other evolving web standards.

This finding therefore attempts to address the problem by taking a step back. We hope to:

Define a conceptual model for identifying related resources that is simple enough to garner community consensus as a reasonable abstraction for the problem.

Show how RDDL 1.0 is one possible concrete syntax for this model.

Show how other concrete syntaxes could be defined and identified in a way that would preserve the model.

For the resource identified by a namespace URI, there may exist other resources related to it. Borrowing on the terminology defined by , we say that each of these other resources has a nature and a purpose. The nature of the resource is a machine-readable label that identifies “what kind of thing” it is. For example, its nature might be “HTML documentation” or “XML Schema” or “CSS Stylesheet”. The purpose of a resource, with respect to the resource identified by the namespace URI, is a machine-readable label that identifies “what use” the thing is. For example, its purpose might be “validation” or “normative reference” or “specification” or “transformation”.

For example, here's a diagram of the model for some DocBook-related resources:

A RDDL 1.0 document encodes the nature and purpose of the related resource in a rddl:resource element. That element uses XLink:

Extacting the model is a simple matter of reading the xlink:href, xlink:role, and xlink:arcrole attributes of each rddl:resource.

One of the RDDL 2.0 proposals encodes the nature and purpose of the related resource directly on the HTML a element:

Extacting the model is a simple matter of reading the rddl:nature, rddl:purpose, and href attributes of each HTML a.

A third approach is to use .

@@describe grddl@@

@@incorporate Dan's USPS example: http://www.w3.org/2000/10/swap/pim/usps

@@note that grddl doesn't actually require xslt except in the general case@@

@@note that the preceding examples use grddl too.@@

@@note that this technique would allow for non-human readable namespace documents but that's counter to the spirit of the webarch good practice.@@

@@ list of natures, borrow from RDDL.

@@ list of purposes, borrow from RDDL.