[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [sca-assembly] CamelCase convention recommendation from OpenCSAliaison committee
Many thanks! -- Robin Robin Cover OASIS, Director of Information Services Editor, Cover Pages and XML Daily Newslink Email: robin@oasis-open.org Staff bio: http://www.oasis-open.org/who/staff.php#cover Cover Pages: http://xml.coverpages.org/ Newsletter: http://xml.coverpages.org/newsletterArchive.html Tel: +1 972-296-1783 On Mon, 24 Nov 2008, Anish Karmarkar wrote: > This only documents the existing practice within SCA dating back to pre 1.0 > days. I, personally don't remember any extensive discussion on the convention > before being used in SCA. The LSC recommended documenting the convention that > already exists. I suspect, the reason SCA chose to use this convention is > because it lines up with the conventions used in the OO world, similar to the > rationale on Eric van der Vlist's blog [1] that you already list at [2]. > > HTH > > -Anish > -- > > [1] > http://eric.van-der-vlist.com/blog/2005/07/29/1315_an_unconventional_xml_naming_convention/ > [2] http://xml.coverpages.org/ndr.html > > Robin Cover wrote: >> Mike, >> >> I think it would be of interest to understand how the new >> formulations relate to one or more of the NDR specifications >> that document common practice in related environments. In >> any case, this information would be useful to me for creating >> a new entry in my NDR overview document: >> >> http://xml.coverpages.org/ndr.html >> [and: http://xml.coverpages.org/camelCase.html ] >> >> Thanks if someone can provide this kind of description. >> >> - Robin >> >> Robin Cover >> OASIS, Director of Information Services >> Editor, Cover Pages and XML Daily Newslink >> Email: robin@oasis-open.org >> Staff bio: http://www.oasis-open.org/who/staff.php#cover >> Cover Pages: http://xml.coverpages.org/ >> Newsletter: http://xml.coverpages.org/newsletterArchive.html >> Tel: +1 972-296-1783 >> >> >> On Fri, 21 Nov 2008, Mike Edwards wrote: >> >>> Folks, >>> >>> The SCA-Policy TC noticed that intents defined in various SCA >>> spec do not follow any particular convention. That TC decided to fix it >>> for the policy specs by adopting the convention of using camelCase with >>> first letter lower case unless the word was an acronym (such as SOAP >>> or JMS). They then asked the liaison committee to make this >>> recommendation to the rest of the OpenCSA TCs. >>> >>> The Liaison subcommittee today decided the following: >>> >>> Liaison committee recommends that all the TC's adopt the Policy TC >>> recommendation that intents use camelCase (first letter lowercase) >>> except for acronyms which would be all upper case. >>> >>> and >>> >>> LSC recommends adding some text to the "conventions" section of the >>> specs which describes the naming conventions: >>> e.g. intents as above, type names are CamelCase, element names are >>> camelCase, attributes are @camelCase are preceded by an "@" sign, etc. >>> >>> ....and that the Assembly TC should take the lead on documenting these >>> conventions by adding >>> a new section at the start of the spec. >>> >>> I will raise an issue for this. >>> >>> 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 >>> >>> >>> >>> >>> >>> >> >> --------------------------------------------------------------------- >> To unsubscribe from this mail list, you must leave the OASIS TC that >> generates this mail. Follow this link to all your TCs in OASIS at: >> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]