tapestry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Tapestry > Version Numbers
Date Tue, 05 Jul 2011 08:45:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/12/_/styles/combined.css?spaceKey=TAPESTRY&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/TAPESTRY/Version+Numbers">Version
Numbers</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~uli">Ulrich
Stärk</a>
    </h4>
        <div id="versionComment">
        <b>Comment:</b>
        Let's stick with Apache nomenclature<br />
    </div>
        <br/>
                         <h4>Changes (4)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >&quot;rc&quot; versions are
&quot;release candidates&quot;; the functionality should be solid; the point of a
release candidate is to get wide exposure to the new codebase to ensure that the final release
is free of bugs. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" >h1. Preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Releases</span>
<span class="diff-added-words"style="background-color: #dfd;">Packages</span>
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >A preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">release</span>
<span class="diff-added-words"style="background-color: #dfd;">package</span> may
be created at any time. A tag is created in Subversion to label the exact source from which
the preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">release</span>
<span class="diff-added-words"style="background-color: #dfd;">package</span> is
generated.  The preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">release</span>
<span class="diff-added-words"style="background-color: #dfd;">package</span> is
built and uploaded to the Apache Nexus. Once uploaded, the master version number (in trunk)
should be advanced to the next index number within the same stability series (example: &quot;5.3-alpha-2&quot;
to &quot;5.3-alpha-3&quot;). <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >The Apache Nexus URL for the preview
<span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">release</span>
<span class="diff-added-words"style="background-color: #dfd;">package</span> may
be distributed on the Tapestry user mailing list. However, preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">releases</span>
<span class="diff-added-words"style="background-color: #dfd;">packages</span>
are deleted, not released. This is important ... preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">releases</span>
<span class="diff-added-words"style="background-color: #dfd;">packages</span>
are never released to the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">
</span> Maven Central repository, only final releases are distributed via Maven Central.
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >A stability vote may follow a
preview <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">release.</span>
<span class="diff-added-words"style="background-color: #dfd;">package.</span>
This is to vote the code base up to the next level of stability (to &quot;beta&quot;,
then &quot;rc&quot;, then &quot;stable&quot;). This a lazy consensus vote.
<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h1. Stable Releases <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        

<div class='panelMacro'><table class='infoMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/information.gif" width="16"
height="16" align="absmiddle" alt="" border="0"></td><td><b>Added in
5.3</b><br /></td></tr></table></div>
<div style="border-right: 20px solid #D8E4F1;border-left: 20px solid #D8E4F1;">
<p>Tapestry version numbering was change starting in release 5.3.  Tapestry 5.2 and
earlier used a different numbering scheme whose primary failing was that, from the version
number, it was not obvious what the <em>stability</em> of the version was.</p>
</div>

<p>This document describes Tapestry's version numbering system. This is important, as
version numbers relate both to artifacts available for download, or from a Maven repository,
and also to bugs recorded in the issue tracking system.</p>

<h1><a name="VersionNumbers-TapestryReleaseNumbers"></a>Tapestry Release
Numbers</h1>

<p>Tapestry release numbers consist of a product version number, and release index number,
seperated by periods, for example "5.3".  The product version number, 5, is unlikely to change
any time soon (it would indicate a non-backwards compatible rewrite of the framework, and
we've had enough of that, thank you very much). </p>

<h1><a name="VersionNumbers-TapestryStableReleaseVersions"></a>Tapestry
Stable Release Versions</h1>

<p>Tapestry stable releases use the name version number as the release number.</p>

<p>A bug fix release follows a stable release, when necessary. Bug fix releases add
a sequence number to the product release number. Thus, the first bug fix release for Tapestry
5.3 will be version 5.3.1, then 5.3.2, as necessary.</p>

<p>A bug fix release <em>replaces</em> the previous stable release. </p>

<h1><a name="VersionNumbers-PreviewVersions"></a>Preview Versions</h1>

<p>During the course of development of a release, there will be preview releases of
non-final versions.  A preview version consists of the product version, a stability term,
and an index number, separated by dashes. The stability term is "alpha", "beta", or "rc".</p>

<p>The index number starts at 1.  A preview version number might be "5.3-alpha-2", or
"5.3-beta-1", for example. The index number resets back to one when the stability itself is
upgraded.</p>

<p>"alpha" versions are not stable; the represent functionality in flux; classes and
methods may be renamed or otherwise refactored between releases.</p>

<p>"beta" versions occur once main functionality is complete; they exist to fix bugs
in both old and new functionality, and fill any gaps in functionality.</p>

<p>"rc" versions are "release candidates"; the functionality should be solid; the point
of a release candidate is to get wide exposure to the new codebase to ensure that the final
release is free of bugs.</p>

<h1><a name="VersionNumbers-PreviewPackages"></a>Preview Packages</h1>

<p>A preview package may be created at any time. A tag is created in Subversion to label
the exact source from which the preview package is generated.  The preview package is built
and uploaded to the Apache Nexus. Once uploaded, the master version number (in trunk) should
be advanced to the next index number within the same stability series (example: "5.3-alpha-2"
to "5.3-alpha-3").</p>

<p>The Apache Nexus URL for the preview package may be distributed on the Tapestry user
mailing list. However, preview packages are deleted, not released. This is important ... preview
packages are never released to the Maven Central repository, only final releases are distributed
via Maven Central.</p>

<p>A stability vote may follow a preview package. This is to vote the code base up to
the next level of stability (to "beta", then "rc", then "stable"). This a lazy consensus vote.</p>

<h1><a name="VersionNumbers-StableReleases"></a>Stable Releases</h1>

<p>Once a version has been voted "stable", a  release may be built and uploaded to the
Apache Nexus. A stable release also includes additional non-Maven artifacts containing the
project's source code, and additional<br/>
artifacts containing JavaDoc or other reports. The other artifacts are distributed via the
Apache Mirrors.</p>

<p>The vote for a  release is a binding vote, requiring at least 3 +1 votes and no vetoes,
as outlined in <a href="http://www.apache.org/foundation/voting.html" class="external-link"
rel="nofollow">http://www.apache.org/foundation/voting.html</a></p>

<p>Following a successful release vote, the final release artifacts in the Apache Nexus
repository may be released to the Maven Central repository, and the additional artifacts moved
into place for download from the  Apache distribution mirrors.  This is also the point at
which the Tapestry wiki is updated to announce the new release (and provide proper links to
it), as well as announcements on the Tapestry user mailing list and elsewhere.</p>

<p>Bug fix releases are follow-ons to stable releases.  Bug fix versions automatically
start at stability "rc", reflecting the fact that only localized bug fixes are expected to
be included in such a release. Once all desired bug fixes are in place, a stability vote (to
"stable") is followed by a release vote.</p>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/TAPESTRY/Version+Numbers">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=27821050&revisedVersion=3&originalVersion=2">View
Changes</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message