Re: [soa-rm-ra] editing convention

["Jeffrey A. Estefan" <jeffrey.a.estefan@jpl.nasa.gov>]

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