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

["Anthony B. Coates (Miley Watts)" <abcoates@mileywatts.com>]

I'm quite happy for us to do that.  Cheers, Tony.

On Mon, 26 Feb 2007 15:45:46 -0000, G. Ken Holman  
<gkholman@CraneSoftwrights.com> wrote:

> 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
>



-- 
Anthony B. Coates
Senior Partner
Miley Watts LLP
Experts In Data
+44 (79) 0543 9026
Data standards participant: ISO 20022 (ISO 15022 XML), ISO 19312,  
UN/CEFACT TMG, MDDL, FpML, UBL.
http://www.mileywatts.com/