ISSUE-82 Inconsistent use of a and an when referring to annotations

http://www.osoa.org/jira/browse/JAVA-82

REF: sca-javacaa-1.1-spec-WD04.doc 

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. 

See [1] for original e-mail posted to the mailing list. 

PROPOSAL: 

Make the usage of a and an consistent when referring to annotations by 

treating "@" as silent when used with annotation such that normal english 

usage prevails. The following examples illustrate this proposal: 

1. a @Reference annotation -- read as, "a reference annotation" 

2. a @Conversational annotation -- read as, "a conversational annotation" 

3. an @EagerInit annotation -- read as, "an eager-init annotation" 

4. a @OneWay annotation -- read as, "a one-way annotation" 

[1] http://lists.oasis-open.org/archives/sca-j/200808/msg00080.html 

Dave Booz

STSM, BPM and SCA Architecture

Co-Chair OASIS SCA-Policy TC and SCA-J TC

"Distributed objects first, then world hunger"

Poughkeepsie, NY (845)-435-6093  or  8-295-6093

e-mail: