Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakarta.ee-community] version numbers and release qualifiers
That is precisely what Maven did for plugins, because it has "M1" or "RC2" but "alpha-1" or "beta-2" at least in the old days.

Markus might ask someone there why this was done at Apache and Maven in particular this way, but especially with the clean slate of Jakarta EE following 8 or 9 I would rather keep it consistent, too. 

Werner 

Stuart Douglas <sdouglas@xxxxxxxxxx> schrieb am Mi., 29. Jan. 2020, 09:45:


On Wed, 29 Jan 2020 at 17:22, Markus KARG <markus@xxxxxxxxxxxxxxx> wrote:

As Maven is case-insensitive, it should be safe to simply proceed without a general rule or recommendaten: It simply makes no difference, so there is no need to direct.


I think it makes for a better user experience if everything is consistent. As it makes no practical difference we should just pick one so users don't have to deal with a mix of upper and lower case.

Stuart
 

After my meeting with Karl-Heinz I think I can tell you more about what the Maven team actually intends.

Regards

-Markus

 

 

Von: Bill Shannon [mailto:bill.shannon@xxxxxxxxxx]
Gesendet: Mittwoch, 29. Januar 2020 02:10
An: Jakarta EE community discussions; Markus KARG
Betreff: Re: [jakarta.ee-community] version numbers and release qualifiers

 

I'd like to close this issue this week, if possible.  I suppose we can always reopen it later if new data arrives.

Markus KARG wrote on 1/28/20 10:39 AM:

I meet Karl-Heinz Marbaise and possibly Robert Scholte in person in March, if this is early enough? Otherwise I can give them a direct call.

-Markus

 

Von: Bill Shannon [mailto:bill.shannon@xxxxxxxxxx]
Gesendet: Dienstag, 28. Januar 2020 08:14
An: Markus KARG; 'Jakarta EE community discussions'
Betreff: Re: AW: [jakarta.ee-community] version numbers and release qualifiers

 

I'm sorry, but I don't have the time to engage with another high volume mailing list.  If you can take care of this, that would be appreciated.

Thanks.

Markus KARG wrote on 1/27/20 10:05 PM:

It's is as simple as you do it here: They have mailing lists. They uses votings.

-Markus

 

 

Von: Bill Shannon [mailto:bill.shannon@xxxxxxxxxx]
Gesendet: Montag, 27. Januar 2020 23:57
An: Jakarta EE community discussions; Markus KARG
Betreff: Re: [jakarta.ee-community] version numbers and release qualifiers

 

I don't know how to ask the entire Maven community.  If you do, please do so and report the results.

Markus KARG wrote on 1/27/20 2:52 PM:

There is a simple answer to find out the Maven community's will: Ask them.

-Markus

 

Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Werner Keil
Gesendet: Montag, 27. Januar 2020 23:51
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] version numbers and release qualifiers

 

If you're saying it's merely for the naming convention of Maven plugins but not any other artifacts, I guess that means it is not really representative or relevant outside that context ;-)

 

And even there it is far from being applied nowadays, the most popular examples are Surefire

 

Werner

 

 

 

On Mon, Jan 27, 2020 at 11:42 PM Markus KARG <markus@xxxxxxxxxxxxxxx> wrote:

I think the question is, what does the Maven community themselves, not what do others at Apache.

-Markus

 

Von: jakarta.ee-community-bounces@xxxxxxxxxxx [mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Werner Keil
Gesendet: Montag, 27. Januar 2020 23:39
An: Jakarta EE community discussions
Betreff: Re: [jakarta.ee-community] version numbers and release qualifiers

 

Because it's not even done by most Apache projects like TomEE

Tomcat 

 or Karaf

 and even Apache Archiva related to Maven itself

 

None of them use lowercase. The only exception seems to be the "incubating" postfix or qualifier, but that doesn't even compare to those mentioned here, because there isn't any identical version number without the "incubating" string, so it's something very Apache Foundation specific.

 

Werner

 

 

 

On Mon, Jan 27, 2020 at 11:20 PM Markus KARG <markus@xxxxxxxxxxxxxxx> wrote:

If Maven's Best Practice is to use lower case, then I do not see why we
should got with upper case instead.
SNAPSHOT is a special case as it is not a static qualifier but actually a
trigger for a dynamic search ("find latest").
-Markus

-----Ursprüngliche Nachricht-----
Von: jakarta.ee-community-bounces@xxxxxxxxxxx
[mailto:jakarta.ee-community-bounces@xxxxxxxxxxx] Im Auftrag von Bill
Shannon
Gesendet: Montag, 27. Januar 2020 22:33
An: Jakara EE community discussions
Betreff: [jakarta.ee-community] version numbers and release qualifiers

As most of you know, our rules for use of version numbers is published here:
https://wiki.eclipse.org/JakartaEE_Maven_Versioning_Rules

I wanted to highlight recent decisions and validate one of them with this
group.


After a discussion in the platform project team, I've updated the rules to
reflect a decision we made:

All Maven programming artifacts (read: jar files containing class files)
are versioned with a three component version number <major>.<minor>.<micro>.
In particular, API jar files use this three component version number, not
the two component number used by specifications.

While, in usual fashion, this is only a recommendation for project teams,
we consider this to be a very *strong* recommendation.


Another issue we decided, but that I haven't updated the document to
reflect,
is that version qualifiers should always be upper case.  Version qualifiers
follow the version number with a dash.  For example, in the version
1.2.3-SNAPSHOT, "SNAPSHOT" is the qualifier.

The other common qualifiers in use are:

M       - milestone
RC      - release candidate
B       - build, or sometimes beta

These qualifiers are followed by a number, allowing for multiple, ordered,
milestones or release candidates or builds/betas.  This results in versions
such as: 1.2.3-M1, 4.5.6-RC2, 7.8.9-B37, etc.

The Maven rules for ordering of versions are here:
https://maven.apache.org/pom.html#Version_Order_Specification

You'll notice that the Maven rules use lower case for the qualifiers
even though Maven ignores case when comparing qualifiers, and SNAPSHOT is
effectively always used in upper case.


While there was a strong consensus in the platform project team that version
qualifiers should always be lower case, I wanted to check with the larger
community to make sure we're not going against some wider community or Maven
or other convention with the use of upper case.

If you have any concern about the use of upper case, and especially if you
can
point to evidence of lower case being a stronger convention, please let me
know.

Silence means you agree upper case is best and thus there's no need to
reply.

Thanks.
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from
this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community





_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

 

 



_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

 

_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

Back to the top