incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christopher <ctubb...@apache.org>
Subject Re: Omitting "-incubating" suffix in Maven artifact version attribute for FreeMarker
Date Wed, 28 Dec 2016 02:18:52 GMT
I think it could also be confusing for users of the Maven version didn't
match the IPMC released version identifier.

If anything, it probably makes more sense to have the '-incubating' in the
groupId , since it's the endorsement of the foundation which is in the
interim state. The groupId typically contains the TLP name, which would be
incubator. So, org.apache.incubator? I would like that along with dropping
the incubating suffix on all artifact versions (Maven or not).

I think it's generally confusing for users to have the suffix present, and
redundant when the artifact readme, pom metadata, or other files explain
it's status more clearly. It also creates excessively long file names and
the naming convention conflicts with other post-version identifiers, such
as Maven classifiers and RPM release/arch info.

On Tue, Dec 27, 2016, 20:18 Daniel Dekany <ddekany@freemail.hu> wrote:

> Hello,
>
> The last release of Apache FreeMarker (incubating) has these Maven
> coordinates:
>
>     <groupId>org.freemarker</groupId>
>     <artifactId>freemarker</artifactId>
>     <version>2.3.25-incubating</version>
>
> The "-incubating" in the Maven version is confusing for the users, as
> it looks as the version number of an unstable release, and it seems
> that this causes many to stick to the last non-Apache release from 1.5
> years ago. (See the "*" footnote if you want some more details.)
>
> As far as I know there's no explicit requirement for having
> "incubating" in the Maven artifact version number. So, I wonder, can
> we just omit "-incubating" from the Maven artifact versions from now
> on? In FreeMarker's case the Maven groupId doesn't contain org.apache
> (I know, it should, but that's a different topic), so I guess there's
> less danger of branding confusion here. Of course, the version number
> would remain x.x.x-incubating in the file names of the releases
> downloadable from apache.org and so on. Also, in case it bothers
> anyone, the "name" element in the Maven POM could be changed from
> "Apache FreeMarker" to "Apache FreeMarker (incubating)" (or just to
> "FreeMarker").
>
> *: For those not working in the Java ecosystem, know that many users
>    will not go to the project home page nowadays to find the latest
>    version, just look at the versions at the Maven Central. Without
>    any place for explanation, "2.3.25-incubating" and such are often
>    believed to be development versions. (I have seen a few user
>    queries that indicated that too.) It certainly doesn't help either
>    that http://mvnrepository.com automatically marks these incubating
>    versions with red (~ alpha). Also, on the same place the last
>    non-Apache release has almost 5x more usages than the last two
>    "-incubating" releases together, which is suspicious. Spring has
>    also stuck at that version for some reason.
>
> --
> Thanks,
>  Daniel Dekany
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message