Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-spec.committee] inconsistent naming for JAXR

There are a few projects that have inconsistencies in the GAV that needs to be addressed, but we said it would happen after EE 8.

On Aug 8, 2019, at 6:26 PM, Kevin Sutter <sutter@xxxxxxxxxx> wrote:

Hi,
As we're working through the JAXR effort, I'm coming across a naming inconsistency.  Looking for advice -- now and later.

According to our Naming convention document (https://github.com/jakartaee/specification-committee/blob/master/names.adoc), JAXR is now known as Jakarta XML Registries, with a code name of xml-registries (plural).

The TCK download site (https://download.eclipse.org/ee4j/jakartaee-tck/jakartaee8-eftl/promoted/) shows a corresponding name of eclipse-xml-registries-tck.zip.

But, the existing GAV for JAXR is as follows:

    <groupId>jakarta.xml.registry</groupId>
    <artifactId>jakarta.xml.registry-api</artifactId>

And, since we're not supposed to modify the GAV for Jakarta EE 8, we have an inconsistency with the use of "registry" for the GAV and "registries" for the tck.

I know this sounds like a nit, but one of my team members that was trying to get the TCK job for JAXR working accidentally followed suit of the "registries" naming convention for accessing the API.  It took "too much time" to discover that problem.  It looked "right", but it sure didn't work right...  :-)

So, do we do anything for Jakarta EE 8?  Or, do we live with this inconsistency?  If we change anything, I would suggest we change the name of the tck file to match the GAV for the api.  But, at this point in the game, maybe that's asking too much.  Depdending on our direction for Jakarta EE 9, we can get all of this naming consistent.  I have not checked if we have other inconsistencies like this.

---------------------------------------------------
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
_______________________________________________
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


Back to the top