Re: [soa-rm-ra] editing convention

[Francis McCabe <frankmccabe@mac.com>]

I agree.

I humbly suggest the definitional style and referencing style for all defined concepts:

term

   A term is a term of common usage.

Some comments about term may be useful here.

Frank

P.S. I am aware that a fair amount of word work will be needed to get to this style.

On Aug 27, 2008, at 1:39 PM, Jeffrey A. Estefan wrote:

Frank,

 

My vote is to be consistent with the convention we used in the RM, which, if I remember correctly, was to use bold on first instance of a concept and lower case in future instances.

 

That said, I also noticed we are not consistent in how we define terms.  In some cases we re-state the term followed by text definition.  In other cases, we just provide the text definition and not re-state the term.  For example, for View in Section 1 (and other related concepts), we show View in bold text and on the definition line, we state "A representation of the whole system...".  Whereas, in Section 3, we define terms like Agent by showing the Agent in bold text and on the definition line, we state "An agent is ...".  Again, we should adopt a convention and use it consistently throughout the RA.

 

Cheers...

 

 - Jeff

smime.p7s