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

[Bill Shannon <bill.shannon@xxxxxxxxxx>]

Kevin Sutter wrote on 7/8/19 6:26 PM:

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).

Do you want to try to write up some guidelines, based on the comments you've already provided?