maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Manfred Moser (JIRA)" <j...@apache.org>
Subject [jira] [Closed] (MNGSITE-167) Maven Getting Started Guide should clarify SNAPSHOT qualifier of 'version' element precedes release
Date Wed, 13 Jan 2016 05:37:40 GMT

     [ https://issues.apache.org/jira/browse/MNGSITE-167?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Manfred Moser closed MNGSITE-167.
---------------------------------
    Resolution: Fixed

> Maven Getting Started Guide should clarify SNAPSHOT qualifier of 'version' element precedes
release
> ---------------------------------------------------------------------------------------------------
>
>                 Key: MNGSITE-167
>                 URL: https://issues.apache.org/jira/browse/MNGSITE-167
>             Project: Maven Project Web Site
>          Issue Type: Bug
>            Reporter: Dan Rollo
>            Assignee: Manfred Moser
>         Attachments: MNGSITE_167_add_missing_description_of_SNAPSHOT.patch
>
>
> In the "Maven Getting Started Guide" 
> http://maven.apache.org/guides/getting-started/index.html
> (linked to as: "Getting Started Tutorial" from: http://maven.apache.org/users/index.html,

> which is linked to as: "Use Maven" from: http://maven.apache.org/
> )
> under the link: "How do I make my first Maven project?", the description bullet for the
"version" pom element mentions SNAPSHOT as follows:
> version  This element indicates the version of the artifact generated by the project.
Maven goes a long way to help you with version management and you will often see the SNAPSHOT
designator in a version, which indicates that a project is in a state of development. We will
discuss the use of snapshots and how they work further on in this guide.
> Though a later description is promised, the concept that a SNAPSHOT version "preceeds"
the non-SNAPSHOT (aka "release") version is never mentioned in this document.
> I have had to describe this fact to a number of people as well, so I think this 'version'
element doc should be changed to mention a SNAPSHOT precedes a release (or some new section
added elsewhere in this doc to clarify this point).
> Here are some of the other responses from the user list that might help to come up with
a clear doco snippet:
> 1. 
> A SNAPSHOT is the development version before producing the release.
> A SNAPSHOT is older than its release
> 1.0.0-SNAPSHOT -> 1.0.0-> 1.0.1-SNAPSHOT -> 1.0.1 -> ..
> 2. 
> 1.0.0 is newer than 1.0.0-SNAPSHOT
> 3. 
> x.x.x-SNAPSHOT is the precursor to x.x.x  The SNAPSHOT value is used to allow
> the version to refer to the 'latest' code along a branch and provides no
> guarantee that the code is stable or unchanging.  The release process changes
> x.x.x-SNAPSHOT to x.x.x, freezes the code to provide a guarantee that the
> version is unchanging.  The release process should also move the version to
> x.x.x+1-SNAPSHOT. 
>  
> It follows that any released code cannot be dependent on SNAPSHOT code
> Below is a thread snippet from maven users mailing list:
> Subject:
> Re: 1.0.0-SNAPSHOT considered older than 1.0.0?
> From:
> <org.apache.maven.user@io7m.com>
> Date:
> 12/20/2012 10:09 AM
> To:
> "Maven Users List" <users@maven.apache.org>
> On Thu, 20 Dec 2012 15:08:26 +0100
> Arnaud Héritier <aheritier@gmail.com> wrote:
> > I don't have the time to check the doc but if it's not in, this is a big
> > error (don't hesitate to open an issue)
> > A SNAPSHOT is the development version before producing the release.
> > A SNAPSHOT is older than its release
> > 1.0.0-SNAPSHOT -> 1.0.0-> 1.0.1-SNAPSHOT -> 1.0.1 -> ..
> Thanks to all that replied.
> The missing documentation I was referring to was:
>   http://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project
> Note:
>   "We will discuss the use of snapshots and how they work further on in
>   this guide"
> The word "snapshots" doesn't appear again on the page.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message