Re: [soa-rm-ra] editing convention

From
Jeffrey A. Estefan <>
Date
2008-08-27T20:39:33+00:00
ID
01ed01c90884$fb6957a0$
Thread
Re: [soa-rm-ra] editing convention
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