Automated QA

XSLT-based tools help ensure that the ARIA suite remains well structured and logically consistent through the course of edits. The tools in this editors suite work on the files in the sources directory and output to the respective publication locations of the documents.

Refer to the technical style guide for information about particular features of the specs that the XSLT transformers expect.

Processing command

Included is a DOS batch file ProcessAria.bat. Execute this with the command "ProcessAria". Executing with no parameters generates all the documents. Executing with a parameter (e.g., "ProcessAria spec" will generate a particular document. The following parameters are supported:

• spec: generate the ARIA specification
• practices: generate the ARIA Best Practices
• primer: generate the ARIA Primer
• roadmap: generate the ARIA Roadmap
• rdf: generate the RDF taxonomy
• module: generate the XHTML module
• sanity: generate the sanity check and diagram sanity check

Shell scripts for other platforms may become available in the future.

XSLT tools

These tools require support for XSLT 2.0. Any XSLT 2.0 processor can be used. The suite has been tested with Saxon for Java. Use Java 1.4 or higher and add saxon9.jar, saxon9-dom.jar, and saxon9-xpath.jar to the classpath. Note: at this time there is a mysterious exception appearing with Saxon 9, and it may be better to use Saxon 8.

Files required

• ProcessAria.bat: DOS batch file to automate the usual tasks
• Spec processing
  • ARIAProcessor.xslt
  • PracticesProcessor.xslt
  • PrimerProcessor.xslt
  • RoadmapProcessor.xslt
  • Shared.xslt: performs functions common for all the specs
  • Cleanup.xslt: Post hoc items like removing list elements that ended up with no children
• Auxiliary document creation
  • roleRDFgenerator.xslt: generates the RDF expression of the Role taxonomy
  • generate-state-module.xslt: generates the XHTML module for the states and properties
• Sanity checking
  • sanitycheck.xslt: checks self-consistency of the spec
  • sanitycheck_uml.xslt: Checks if UML diagram has gotten out of date with the specs, but comparing the XML output of the UML diagram software with the output of roleXMIgenerator.xslt
  • roleXMIgenerator.xslt: generates a UML model of the Role taxonomy, in the XMI format. This is used for comparison with the output of the UML diagram software, to determine if the diagram needs to be updated.