Fwd: [chairs] FW: New Specification Templates and Guidelines now Available

["G. Ken Holman" <gkholman@CraneSoftwrights.com>]

Just a quick note regarding the new OASIS guidelines for documentation.

Note that URN protocol strings are still allowed for namespace URI 
strings, but with the adoption of RDDL attributes does it make sense 
for us to move to an HTTP protocol string for the code list URI 
string so that we have RDDL documentation at the URL of the URI?

(try to say that three times fast!)

. . . . . . . . . . . . . Ken

>From: "Mary McRae" <mary.mcrae@oasis-open.org>
>To: <chairs@lists.oasis-open.org>
>Date: Wed, 21 Feb 2007 13:51:35 -0500
>Organization: OASIS
>
>To all TC Chairs and Secretaries:
>
>Please pass this information along to your specification editors. 
>OASIS policy requires that all specifications must conform to the 
>OASIS-supplied templates.
>
>An updated set of templates has been created to align with the 
>"Guidelines for Filenames, URIs, Namespaces and Metadata 
>(<http://docs.oasis-open.org/specGuidelines/namingGuidelines/resourceNaming.html>http://docs.oasis-open.org/specGuidelines/namingGuidelines/resourceNaming.html) 
>as well as the OASIS Naming Guidelines: Metadata and Versioning 
>(<http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html>http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html) 
>policies that were approved last fall.
>
>The main template index page is here: 
><http://docs.oasis-open.org/templates/index.html>http://docs.oasis-open.org/templates/index.html. 
>Templates are provided in several formats: Microsoft Word, 
>OpenOffice Writer, and XHTML. Please note that there are two 
>versions for each application - one in which the Notices section 
>conforms to TCs operating under the 15 April 2005 IPR Policy, and 
>the other noted as 'legacy' which cites the previous Notices section.
>
>The XHTML user guide 
>(<http://docs.oasis-open.org/templates/OASISSpecificationTemplateGuidelines.html>http://docs.oasis-open.org/templates/OASISSpecificationTemplateGuidelines.html) 
>should be used in conjunction with all templates; the Word user 
>guide - while containing useful information on the application of 
>styles and field codes - has not been updated to include the new 
>metadata and remove the obsolete categories.
>
>OASIS encourages the use of RDDL (Resource Directory Description 
>Language) documents to describe XML namespaces. A template is now 
>available: 
><http://docs.oasis-open.org/templates/rddl.html>http://docs.oasis-open.org/templates/rddl.html. 
>This template should be considered 'alpha'; it is anticipated that 
>it will be updated frequently as we determine 'best practices' 
>related to its usage.
>...



--
World-wide corporate, govt. & user group XML, XSL and UBL training
RSS feeds:     publicly-available developer resources and training
G. Ken Holman                 mailto:gkholman@CraneSoftwrights.com
Crane Softwrights Ltd.          http://www.CraneSoftwrights.com/o/
Box 266, Kars, Ontario CANADA K0A-2E0    +1(613)489-0999 (F:-0995)
Male Cancer Awareness Aug'05  http://www.CraneSoftwrights.com/o/bc
Legal business disclaimers:  http://www.CraneSoftwrights.com/legal