Manual to edit The QA Matrix

The Matrix is a page which gives information about the W3C specifications, featuring a synthetic table with information useful for specification implementors. At first, it was managed using an XML vocabulary, but is now managed using an RDF system, allowing both a better design of the semantics involved and an easier maintenance, relying on the Technical Reports Management Automation.

This document describes the process and steps involved in the maintenance of this document.

Overview of the process

The Matrix is maintained by adding any new information received on a given technical report to an existing base of knowledge formatted in Notation3 (N3), an easy-to-write syntax for RDF. This knowledge base uses a specially crafted RDF Schema.

This knowledge base is then merged with the base of knowledge about W3C Technical Reports, maintained by the Webmaster, to generate an RDF view of the Matrix, which is then transformed into its main XHTML view through XSLT.

How to Update The Matrix


To manage the Matrix, you need the following tools installed on your system:

Besides, you need to have the following data (publicly accessible on the W3C site) on your filesystem, in a hierarchy similar to the one used on the site:

Besides, it is necessary that the maintainer has a basic understanding of the N3 syntax.

Updating the knowledge base

To update the knowledge base, simply add at the end of the file a line such as <> :hasConformanceSection <>. (the first URI being the latest version URI of the said specification, the :hasConformanceSection one of the property defined in the schema, and the second URI the object of this property.

Updating the RDF Version

Once the knowledge base updated (or if you want to bring the Matrix up to date with regard to the Technical Reports list), use the following command line: cwm QA/2002/10/merge-tr-matrix.n3 --think QA/2002/10/matrix-base.n3 --rdf 2002/01/tr-automation/tr.rdf --filter=QA/2002/10/filter-matrixdata.n3 --rdf > QA/TheMatrix.rdf (or simply use the relevant Makefile rule).

This command line has for effect to:

  1. load the 2 knowledge bases and identify in them the relevant Technical Reports (done by merge-tr-matrix.n3)
  2. merge the 2 knowledge bases
  3. filter the merged output to only keep relevant data about relevant Technical Reports (done by --filter=QA/2002/10/filter-matrixdata.n3)
  4. put the output in TheMatrix.rdf

The XHTML version

Never edit directly the file /QA/TheMatrix.html. This file is created when you run the xsl stylesheet.

The command to run the xslt stylesheet is (as described in the Makefile: xsltproc QA/TheMatrix.rdf QA/2002/10/toMatrix.xsl > QA/TheMatrix.html

Vocabulary used in the N3 Knowledge base

The knowledge base uses a specially crafted RDF Schema in a Notation3 syntax. While this schema is self-describing (and human readable through a client-side XSLT if your user agent supports it), this document quickly describes its most important properties (assuming that the mat prefix is bound to namespace):

points to the conformance section of the given specification
points to the list of the known errata for the given specification
points to the archives of a mailing list used to comment on the specification
point to the implementation report of the specification
point to the interoperability report of the specification
points to the maintained list of Last Call issues for the specification
points to a document gathering the requirements on which the specification is built
points to a description of an existing test suite that can be used to test the implementation of the specification
points to the list of known translations for the specification
points to a validation service for the specification

Besides these properties, the knowledge base uses vocabulary from the Dublin Core Schema, used to describe simple bibliographic data.

Benefits of the RDF-management of the Matrix

The fact that the Matrix is now managed through an RDF vocabulary, and more generally with Semantic-Web enabled technologies bring the following benefits:

For more details on this topic, see why we're using RDF to manage the matrix.

Valid XHTML 1.0!

Created Date: 2002-06-04 by Karl Dubost
Last modified $Date: 2011/12/16 02:56:54 $ by $Author: gerald $

Copyright © 2000-2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.