[OASIS Issue Tracker] Commented: (TOSCA-10) Metamodel entity names should be in monospaced typeface

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/TOSCA-10?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=29735#action_29735 ] 

Thomas Spatzier  commented on TOSCA-10:
---------------------------------------

Richard sent a  response by mail regarding the lines below and my earlier comment - pasting the information here to have it recorded in this issue.

Line 896: DeploymentArtifact
Line 897: DeploymentArtifact
Line 900: DeploymentArtifacts
Line 901: DeploymentArtifacts
Line 942: RelationshipTypeProperties
Line 946: RelationshipTypeProperties

"Yes, I think this is a source of confusion (at least it was for me). I think what threw me off was the capitalization. 

If I have a language construct called Class, and I then want to talk about why one needs to have classes, I wouldn't capitalize the word. But if I want to give an example of how to create the Class called "Server" (for example), then I would capitalize it, to indicate I meant the keyword.

And you took this same approach, when you uncapitalized "properties" in lines 942/946. But should deployment artifact be capitalized? What do others think?

This is why it makes sense to monospace the keywords, so there is no ambiguity."


> Metamodel entity names should be in monospaced typeface
> -------------------------------------------------------
>
>                 Key: TOSCA-10
>                 URL: http://tools.oasis-open.org/issues/browse/TOSCA-10
>             Project: OASIS Topology and Orchestration Specification for Cloud Applications (TOSCA) TC
>          Issue Type: Task
>          Components: Spec
>    Affects Versions: CSD2
>            Reporter: Paul Lipton 
>            Assignee: Arvind Srinivasan 
>             Fix For: CSD2
>
>
> From approved motion made at TC meeting of March 1, 2012 (see meeting minutes at: http://www.oasis-open.org/apps/org/workgroup/tosca/download.php/45330/latest). 
> Motion: Entity names from the metamodel in the spec should be specified in a monospaced typeface, such as New Courier.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira