Re: [sdd] Writer's Conventions

[Brent Miller <bamiller@us.ibm.com>]

In response to David's suggestion below,
I contacted Ram Kumar, our TC's OASIS representative. Ram's reply:

------------------------

Hi Brent,
 
1. Naming conventions for schema
files - we decided to leave this up to the TC as some like to include version
info and others don't.
2. Guideslines for developing
specifications - no formal writing guidelines, but we do have templates
that must be adhered to (docs.oasis-open.org/templates/)
3. Guideslines for developing
schemas - again, no formal writing guidelines, but there's lots of "best
practices" stuff out there. The UBL Naming and Design Rules are a
good place to start.
 
Regards,
 
Ram

----------------------- end of Ram's
reply

It seems we're taking the right approach
with our TC's writers' conventions. We need to ensure that we're using
the specification template, and we might want to investigate some of the
best practices.

Regards,
Brent

Brent A. Miller
STSM, Autonomic Computing Architecture
IBM Corp.
Tel. 919-543-6959 (TIE 441)

"In theory, there is no difference between theory and practice. But,
in practice, there is." 
-- Jan L.A. van de Snepscheut

David Snelling <David.Snelling@UK.Fujitsu.com>

07/15/2006 01:46 PM

To	Randy George/Austin/IBM@IBMUS
cc	sdd@lists.oasis-open.org
Subject	Re: [sdd] Writer's Conventions

Randy,

I seem to recall that OASIS to have some guidelines available on  
this. I think we used them for WSRF. It included both file names and  
QNames. Ask which ever OASIS staff member is your contact.

On 14 Jul 2006, at 16:53, Randy George wrote:

>
> In this week's TC meeting, we approved the proposed writer's  
> conventions.  One area not addressed in this document is naming
 
> conventions for the XSD files.  The question that I have to the
TC  
> is do we care about some "formal convention" for naming
our XSD  
> files?  If so, does anyone have a proposal?  I looked around
at  
> various OASIS standards and their is no consistency what so ever in
 
> naming XSD files.
>
> Regards,
> Randy George
>
> Senior Technical Staff Member
> Provisioning Architecture
> Tivoli Software, IBM Software Group
> Austin, TX
> (512) 838-0752     T/L 678-0752

-- 

Take care:

     Dr. David Snelling < David . Snelling . UK . Fujitsu
. com >
     Fujitsu Laboratories of Europe
     Hayes Park Central
     Hayes End Road
     Hayes, Middlesex  UB4 8FE

     +44-208-606-4649 (Office)
     +44-208-606-4539 (Fax)
     +44-7768-807526  (Mobile)