[July 05, 2002] An 'OASIS Specification Tools' is developing tools and guidelines for writing OASIS specification documents.
Description 2002-07: "The OASIS specification tools are produced by a group of interested OASIS members. There is no formal Technical Committee for this work. Our goal is to produce tools and guidelines for use by OASIS Technical Committees in creating and publishing specifications, and to make updates on an ad hoc basis. An informal spectools mailing list is used for discussion of OASIS specification tools and guidelines." Providers of tools and guidelines [2002-07-06] were listed as Eve Maler (maintainer of the website) and Norman Walsh (both of Sun Microsystems).
The document repository includes [2002-07]: (1) the Specification Template Instructions, explaining "how to use the available templates and tools to create OASIS publications. It covers the proposed convention for file naming and other rules for how to fill in document metadata." (2) A DocBook Template -- the XML file is the actual template to use; the HTML and PDF files show the results of using the stylesheets found in the stylesheet repository. (3) A MS Word Sample: "The Word file was prepared in Microsoft Word 2002; it is the actual file to start with in editing a new document, along with the Word template The PDF file is a non-revisable version of the sample for viewing." (4) A Microsoft Word Template; "this Word template does not use revision numbers in the file name, so that it is easy for you to update your templates directory with new versions and have them apply to your existing documents."
A stylesheet repository contains the XSL stylesheets and auxiliary files related to formatting OASIS publications encoded in DocBook.
A Specification Template Instructions document outlines "the recommended best practices for writing OASIS standards-track documents in DocBook, 'Office' applications, and XHTML." This document in XML format supplies an example; it comforms to the DocBook 4.1.2 DTD (http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd.
References:
- OASIS Specification Tools website
- Mailing list archives
- Document repository
- Stylesheet repository
- Specification Template Instructions. Working Draft 01. 26-April-2002. [cache]
