sca-assembly message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: [NEW ISSUE] Add a Section documenting naming conventions to the start ofthe SCA Assembly Specification
- From: Mike Edwards <mike_edwards@uk.ibm.com>
- To: "OASIS Assembly" <sca-assembly@lists.oasis-open.org>
- Date: Fri, 21 Nov 2008 09:56:19 +0000
Raiser:
Mike Edwards
Target:
SCA Assembly Specification: sca-assembly-1.1-spec-cd01-rev3.doc
Description:
The SCA Liaison committee has asked
us to add a small section on naming conventions to the
frontmatter of the SCA Assembly specification.
This needs to cover conventions for
the names that are defined by SCA in particular:
- names of elements and attributes in
XSD files
- names of intents
Proposal:
Add a new section, 1.3, following line
62:
1.3 Naming Conventions
This specification follows some naming
conventions for artifacts defined by the specification,
as follows:
- For the names of elements and the names
of attributes within XSD files, the names follow
the CamelCase convention, with all names starting with a lower case letter.
eg <element
name="componentType"
type="sca:ComponentType"/>
- For the names of types within XSD files,
the names follow the CamelCase convention with
all names starting with an upper case letter
eg. <complexType
name="ComponentService">
- For the names of intents, the names
follow the CamelCase convention, with all names
starting with a lower case letter, EXCEPT for cases where the intent represents
an
established acronym, in which case the entire name is in upper case.
An example of an intent which is an acronym is the "SOAP" intent.
Yours, Mike.
Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014 Mobile: +44-7802-467431
Email: mike_edwards@uk.ibm.com
Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number
741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6
3AU
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]