ISSUE 49: Add an optional description attribute to promoted properties, references and services

[Scott Vorthmann <scottv@tibco.com>]

http://www.osoa.org/jira/browse/ASSEMBLY-49

On Feb 13, 2008, at 3:08 AM, Mark Combellack wrote:

> RAISER:           Mark Combellack
>
> TARGET:          SCA Assembly Specification
>
> DESCRIPTION:
>
> It is currently envisioned that an Application Assembler can take a  
> Composite written by another person and use it in their own  
> applications. Often these “3rdparty” Composites will have promoted  
> Properties and References that will need to be set by the  
> Application Assembler. From the SCDL, the Application Assembler has  
> only the name of the promoted Properties and References to document  
> what they do.
>
> What is missing is the ability for the Composite Developer to add a  
> short description to promoted Properties and References that would  
> inform the Application Assembler what they are for.
>
> It may also be desirable to add a description to promoted Services  
> as well.
>
> PROPOSAL:
>
> Add an optional “description” attribute to Property, Reference and  
> Service that would allow the Composite Developer to write a brief  
> description of them.
>