[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Inconsistent use of a and an when referring to annotations in the document
REF: sca-javacaa-1.1-spec-WD04.doc This can be considered as an editorial change (if at all). I am noticing that in the document the use of a and an with annotations is not consistent. For e,g, Line 342: A @Reference to a conversational service is injected Line 437: interfaces declare a @ConversationAttributes annotation, ... Line 1437: The presence of a @Reference annotation is reflected ... Line 1683: A @Service annotation with no attributes is meaningless ... Line 1709-1710: a @WebService annotation on the class ... Line 96-97: ... an @Reference annotation. Line 255-256: ... an @OneWay annotation. Line 263-264: ... an @Conversational annotation. What is the general practice? 1. Should it always be 'an' since there is an 'at' symbol? 2. Should the @ symbol be ignored always in deciding on the article? Example: A @Reference to a conversational service is injected --- will be read as, "a reference to a conversational service ..." A @Service annotation with no attributes ... --- will be read as, "a service annotation with no attributes ..." An @Init annotation on a method ... --- will be read as, "an init annotation ... " A @OneWay annotation on a method ... ---- will be read as, "a oneway annotation on a method ..." 3. Should it be 'an' when referrring to the annotation with the word 'annotation' following the annotation itself and other times the @ is ignored. Example: A @Reference to a conversational service is injected --- will be read as, "a reference to a conversational service ..." An @Reference annotation on a field ... --- will be read as, "an at reference annotation on a field ..." An @Service annotation with no attributes ... --- will be read as, "an at service annotation with no attributes ..." An @Init annotation on a method ... --- will be read as, "an at init annotation ... " An @OneWay annotation on a method ... ---- will be read as, "an at oneway annotation on a method ..." You get the idea what I am talking about. ++Vamsi
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]