Re: [jakarta.ee-spec.committee] acronyms vs. names

["Kevin Sutter" <sutter@xxxxxxxxxx>]

Bill,
>  Kevin,
some of the PR comments I've seen suggest that you have some guidelines
in mind.  Have you written them down somewhere?

No, just trying
to interpret the the rules and trying to be consistent with my comments.
 Although the guidelines given to us by Oracle allow us to use acronyms
with the proper explicit attribution, I actually find that even more intrusive
than just changing the references to use the new project/spec names.  There
are some cases where the acronym usage makes sense, especially when we're
referring to technologies prior to Java EE 8.  But, in most cases,
it's just easier and more readable to change JSF to Jakarta Server Faces
(as an example).

---------------------------------------------------
Kevin Sutter 
STSM, MicroProfile and Jakarta EE architect
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn: https://www.linkedin.com/in/kevinwsutter



From:
       Bill
Shannon <bill.shannon@xxxxxxxxxx>
To:
       Jakarta
specification committee <jakarta.ee-spec.committee@xxxxxxxxxxx>
Date:
       07/08/2019
07:30 PM
Subject:
       [EXTERNAL]
Re: [jakarta.ee-spec.committee] acronyms vs. names
Sent
by:        jakarta.ee-spec.committee-bounces@xxxxxxxxxxx

---

Kevin, some of the PR comments I've
seen suggest that you have some guidelines
in mind.  Have you written them down somewhere?

Bill Shannon wrote on 7/8/19 5:11 PM:
> Some of you were busy while those of us in the US enjoyed the holiday
weekend!  :-)
> 
> I found 300 messages in my mailbox this morning.  I haven't gotten
through
> even half of them yet, but one issue has become apparent...
> 
> Do we intend that everyone replaces all uses of acronyms with the
> full specification name in all of our specifications, javadocs, etc.?
> The approved acronym guidelines do not require that, so this is mostly
> a question of style.  With different people updating different
parts of
> the platform spec, for example, it would be helpful to have guidelines
> that everyone applied equally so that we end up with a consistent
style.
> 
> If there was a message explaining the guidelines, sorry if I haven't
> gotten to it yet...
> 
_______________________________________________
jakarta.ee-spec.committee mailing list
jakarta.ee-spec.committee@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe
from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee