Author: buildbot
Date: Tue Jan 6 20:19:55 2015
New Revision: 935301
Log:
Production update by buildbot for tapestry
Modified:
websites/production/tapestry/content/cache/main.pageCache
websites/production/tapestry/content/release-process.html
Modified: websites/production/tapestry/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/tapestry/content/release-process.html
==============================================================================
--- websites/production/tapestry/content/release-process.html (original)
+++ websites/production/tapestry/content/release-process.html Tue Jan 6
20:19:55 2015
@@ -132,42 +132,34 @@ signing.secretKeyRingFile=.../.gnupg/sec
signing.password=...
apacheArchivesFolder=.../tapestry-dev]]></script>
-</div></div><p>You can find your keyId using <code>gpg
--list-keys</code>.</p><p> The apacheArchivesFolder should be the full
path to your dev archives workspace. The build will copy files to this
folder; see further notes below.</p><h2
id="ReleaseProcess-ReleaseSteps">Release Steps</h2><h3
id="ReleaseProcess-GeneratetheRelease">Generate the Release</h3><ul><li>Update
your workspace to the release branch<ul><li>For current work, the release
branch is <em>master</em></li><li>When creating bug fix releases for older
releases, the branch will match the release,
e.g., <em>5.3</em></li></ul></li><li><span style="line-height:
1.4285715;">Run the build using </span><code style="line-height:
1.4285715;">gradle generateRelease</code><br clear="none"><ul><li>This will
create, sign, and upload JAR files and other artifacts to the Nexus
repository</li><li>It will also create, sign, and copy the source, binary, and
documentation archives to your dev archives workspace</l
i></ul></li><li>Tag the release in Git, then push the changes up to the Apache
repository:<ul><li><code>git tag 5.x</code></li><li><code>git push
--tags</code></li></ul></li><li>Login to <a shape="rect"
class="external-link"
href="https://repository.apache.org/index.html#stagingRepositories";>Nexus</a> and <strong>close</strong> the
automatically created staging repository</li></ul><h3
id="ReleaseProcess-CommittheArchives">Commit the Archives</h3><ul><li>The build
will have copied archive files to your dist workspace</li><li><code>svn
add</code> the new files</li><li><code>svn commit</code> to copy the files up
to Apache (this is <em>slow</em>)<ul><li>Use the full version number as
the commit message, e.g., <em>5.4-beta-26</em></li></ul></li><li>You can
verify the files via the web: <a shape="rect" class="external-link"
href="https://dist.apache.org/repos/dist/dev/tapestry";>https://dist.apache.org/repos/dist/dev/tapestry</a></li></ul><h3
id="Release
Process-BumptheVersionNumber">Bump the Version
Number</h3><ul><li>Update <code>build.gradle</code> to increment the
version number</li><li>Increment the minor version number (inside the
tapestryVersion method, near the top of the file)</li><li><p>Commit and push
the changes</p></li></ul><h3 id="ReleaseProcess-SendVote">Send
Vote</h3><ul><li><span style="line-height: 1.4285715;">Send vote
email</span></li><li><span style="line-height: 1.4285715;"><strong>Wait 3
days</strong><br clear="none"></span></li><li><span style="line-height:
1.4285715;">The vote is successful if there are at least
three <strong>+1</strong>'s and more <strong>+1</strong> than
<strong>-1</strong></span></li><li><span style="line-height: 1.4285715;">Only
PMC members may cast binding votes<br clear="none"></span></li></ul><h3
id="ReleaseProcess-"><span style="line-height:
22.857143px;"> </span></h3><h3
id="ReleaseProcess-UpdateJIRAandgeneratereleasenotes"><span>Update JIRA and
generate release
notes</span></h3><h3 id="ReleaseProcess-.1"><span style="line-height:
22.857143px;"> </span></h3><ul><li><span>Use the </span><a
shape="rect" class="external-link"
href="https://issues.apache.org/jira/plugins/servlet/project-config/TAP5/versions";>Manage
Versions page</a><span> in JIRA to add a new version (this is often not
necessary as it is often created by someone
earlier)</span></li><li><strong>Release</strong> the version, moving
outstanding issues to the next version</li><li>Generate HTML Release
Notes<ul><li>Visit the <a shape="rect" class="external-link"
href="https://issues.apache.org/jira/browse/TAP5#selectedTab=com.atlassian.jira.plugin.system.project:versions-panel&subset=-1";>TAP5
Versions pages in JIRA</a></li><li>Choose the correct version
number</li><li>Click "Release Notes" (upper right corner of the
page)</li><li>Create a new Confluence child page of <a shape="rect"
href="release-notes.html">Release Notes</a> (it may already ex
ist)</li><li>Update with text about any unusual aspects of the upgrade
(especially, non-backwards compatible changes)</li><li>Paste the HTML release
notes content into the new page (you'll have to use the {html}
macro)</li><li>Rename the "Bug" heading to "Bugs Fixed", "Improvement" to
"Improvements Made", "New Feature" to "New Features
Added"</li><li>Update <a shape="rect" href="release-notes.html">Release
Notes</a> index page to point to the new page</li></ul></li></ul><h3
id="ReleaseProcess-ReleasetheMavenArtifacts"><span style="line-height:
22.857143px;">Release the Maven Artifacts</span></h3><ul><li>Login to <a
shape="rect" class="external-link"
href="https://repository.apache.org/index.html#stagingRepositories";>Nexus</a>
and <strong>release</strong> the version's repository<ul><li>Enter "Apache
Tapestry 5.x" (adjust as necessary) for the message</li><li>The version will
disappear from the list of repositories after releasing
it</li></ul></li><li>Releasing will ultimat
ely get the artifacts up to the central Maven repository</li></ul><h3
id="ReleaseProcess-ReleasetheArchives">Release the Archives</h3><ul><li>Copy
the release archives files (including checksums and GPG signatures) to the
release archives workspace</li><li>Change to the release archives
workspace</li><li><code>svn add</code> and <code>svn commit</code>, as
with the dev archives workspace</li></ul><h3
id="ReleaseProcess-ReleasetheKraken">Release the Kraken</h3><ul><li>This occurs
automatically</li></ul><h3 id="ReleaseProcess-Wait">Wait</h3><ul><li>You must
wait at least 24 hours for the archives and artifacts to be distributed to the
Apache mirrors and to the central Maven repository</li></ul><h3
id="ReleaseProcess-UpdateDocumentation"><span style="line-height:
1.4285715;">Update Documentation</span></h3><ul><li><span style="line-height:
1.4285715;">Update the release number listed in the following pages in the
Confluence wiki:</span><br clear="none"><ul><li><a shape="rect" href
="download.html">Download</a> page</li><li>(Optional) Tutorial <a shape="rect"
href="creating-the-skeleton-application.html">Creating The Skeleton
Application</a> page: Tapestry version number in the
archetype</li><li>(Optional) <a shape="rect"
href="getting-started.html">Getting Started</a> page: Tapestry version number
in the archetype</li></ul></li><li><span>Change to the site content
workspace</span></li><li><code>svn update</code> to get any recent
changes</li><li><span>Edit </span><code>archetype-catalog.xml</code><span> to
add or update a new entry for the release</span></li><li><span
style="line-height: 1.4285715;">Update the release number and date
inside </span><code style="line-height: 1.4285715;">doap.rdf</code><span
style="line-height: 1.4285715;">  (this is a </span><a shape="rect"
class="external-link" href="https://projects.apache.org/doap.html";
style="line-height: 1.4285715;">description file</a><span style="line-height:
1.4285715;"> for the
project)</span></li><li><span style="line-height: 1.4285715;"><code>svn
commit</code></span></li></ul><h3 id="ReleaseProcess-Done!"><span
style="line-height: 1.4285715;">Done!</span></h3><h2
id="ReleaseProcess-Atemplateforthevotee-mail:">A template for the vote
e-mail:</h2><div class="preformatted panel" style="border-width: 1px;"><div
class="preformattedContent panelContent">
-<pre>I've created and uploaded a release of Tapestry 5.x, ready to be voted
upon.
+</div></div><p>You can find your keyId using <code>gpg
--list-keys</code>.</p><p> The apacheArchivesFolder should be the full
path to your dev archives workspace. The build will copy files to this
folder; see further notes below.</p><h2
id="ReleaseProcess-ReleaseSteps">Release Steps</h2><h3
id="ReleaseProcess-GeneratetheRelease">Generate the Release</h3><ul><li>Update
your workspace to the release branch<ul><li>For current work, the release
branch is <em>master</em></li><li>When creating bug fix releases for older
releases, the branch will match the release,
e.g., <em>5.3</em></li></ul></li><li><span style="line-height:
1.4285715;">Run the build using </span><code style="line-height:
1.4285715;">gradle generateRelease</code><br clear="none"><ul><li>This will
create, sign, and upload JAR files and other artifacts to the Nexus
repository</li><li>It will also create, sign, and copy the source, binary, and
documentation archives to your dev archives workspace</l
i></ul></li><li>Tag the release in Git, then push the changes up to the Apache
repository:<ul><li><code>git tag 5.x</code></li><li><code>git push
--tags</code></li></ul></li><li>Login to <a shape="rect"
class="external-link"
href="https://repository.apache.org/index.html#stagingRepositories";>Nexus</a> and <strong>close</strong> the
automatically created staging repository</li></ul><h3
id="ReleaseProcess-CommittheArchives">Commit the Archives</h3><ul><li>The build
will have copied archive files to your dist workspace</li><li><code>svn
add</code> the new files</li><li><code>svn commit</code> to copy the files up
to Apache (this is <em>slow</em>)<ul><li>Use the full version number as
the commit message, e.g., <em>5.4-beta-26</em></li></ul></li><li>You can
verify the files via the web: <a shape="rect" class="external-link"
href="https://dist.apache.org/repos/dist/dev/tapestry";>https://dist.apache.org/repos/dist/dev/tapestry</a></li></ul><h3
id="Release
Process-BumptheVersionNumber">Bump the Version
Number</h3><ul><li>Update <code>build.gradle</code> to increment the
version number</li><li>Increment the minor version number (inside the
tapestryVersion method, near the top of the file)</li><li><p>Commit and push
the changes</p></li></ul><h3 id="ReleaseProcess-SendVote">Send
Vote</h3><ul><li><span style="line-height: 1.4285715;">Send vote
email</span></li><li><span style="line-height: 1.4285715;"><strong>Wait 3
days</strong><br clear="none"></span></li><li><span style="line-height:
1.4285715;">The vote is successful if there are at least
three <strong>+1</strong>'s and more <strong>+1</strong> than
<strong>-1</strong></span></li><li><span style="line-height: 1.4285715;">Only
PMC members may cast binding votes</span></li></ul><h3
id="ReleaseProcess-UpdateJIRAandgeneratereleasenotes"><span>Update JIRA and
generate release notes</span><span style="line-height:
22.857143px;"> </span></h3><ul><li><span>Use the </s
pan><a shape="rect" class="external-link"
href="https://issues.apache.org/jira/plugins/servlet/project-config/TAP5/versions";>Manage
Versions page</a><span> in JIRA to add a new version (this is often not
necessary as it is often created by someone
earlier)</span></li><li><strong>Release</strong> the version, moving
outstanding issues to the next version</li><li>Generate HTML Release
Notes<ul><li>Visit the <a shape="rect" class="external-link"
href="https://issues.apache.org/jira/browse/TAP5#selectedTab=com.atlassian.jira.plugin.system.project:versions-panel&subset=-1";>TAP5
Versions pages in JIRA</a></li><li>Choose the correct version
number</li><li>Click "Release Notes" (upper right corner of the
page)</li><li>Create a new Confluence child page of <a shape="rect"
href="release-notes.html">Release Notes</a> (it may already
exist)</li><li>Update with text about any unusual aspects of the upgrade
(especially, non-backwards compatible changes)</li><li>Paste
the HTML release notes content into the new page (you'll have to use the
{html} macro)</li><li>Rename the "Bug" heading to "Bugs Fixed", "Improvement"
to "Improvements Made", "New Feature" to "New Features
Added"</li><li>Update <a shape="rect" href="release-notes.html">Release
Notes</a> index page to point to the new page</li></ul></li></ul><h3
id="ReleaseProcess-ReleasetheMavenArtifacts"><span style="line-height:
22.857143px;">Release the Maven Artifacts</span></h3><ul><li>Login to <a
shape="rect" class="external-link"
href="https://repository.apache.org/index.html#stagingRepositories";>Nexus</a>
and <strong>release</strong> the version's repository<ul><li>Enter "Apache
Tapestry 5.x" (adjust as necessary) for the message</li><li>The version will
disappear from the list of repositories after releasing
it</li></ul></li><li>Releasing will ultimately get the artifacts up to the
central Maven repository</li></ul><h3
id="ReleaseProcess-ReleasetheArchives">Release the Archives</h
3><ul><li>Copy the release archives files (including checksums and GPG
signatures) to the release archives workspace</li><li>Change to the release
archives workspace</li><li><code>svn add</code> and <code>svn
commit</code>, as with the dev archives workspace</li></ul><h3
id="ReleaseProcess-ReleasetheKraken">Release the Kraken</h3><ul><li>This occurs
automatically</li></ul><h3 id="ReleaseProcess-Wait">Wait</h3><ul><li>You must
wait at least 24 hours for the archives and artifacts to be distributed to the
Apache mirrors and to the central Maven repository</li></ul><h3
id="ReleaseProcess-UpdateDocumentation"><span style="line-height:
1.4285715;">Update Documentation</span></h3><ul><li><span style="line-height:
1.4285715;">Update the release number listed in the following pages in the
Confluence wiki:</span><br clear="none"><ul><li><a shape="rect"
href="download.html">Download</a> page</li><li>(Optional) Tutorial <a
shape="rect" href="creating-the-skeleton-application.html">Creatin
g The Skeleton Application</a> page: Tapestry version number in the
archetype</li><li>(Optional) <a shape="rect"
href="getting-started.html">Getting Started</a> page: Tapestry version number
in the archetype</li></ul></li><li><span>Change to the site content
workspace</span></li><li><code>svn update</code> to get any recent
changes</li><li><span>Edit </span><code>archetype-catalog.xml</code><span> to
add or update a new entry for the release</span></li><li><span
style="line-height: 1.4285715;">Update the release number and date
inside </span><code style="line-height: 1.4285715;">doap.rdf</code><span
style="line-height: 1.4285715;">  (this is a </span><a shape="rect"
class="external-link" href="https://projects.apache.org/doap.html";
style="line-height: 1.4285715;">description file</a><span style="line-height:
1.4285715;"> for the project)</span></li><li><span style="line-height:
1.4285715;"><code>svn commit</code></span></li></ul><h3
id="ReleaseProcess-Done!"
><span style="line-height: 1.4285715;">Done!</span></h3><h2
>id="ReleaseProcess-Atemplateforthevotee-mail:">A template for the vote
>e-mail:</h2><div class="code panel pdl" style="border-width: 1px;"><div
>class="codeContent panelContent pdl">
+<script class="theme: Default; brush: java; gutter: false"
type="syntaxhighlighter"><![CDATA[I've created and uploaded a release of
Tapestry 5.x, ready to be voted upon.
The source, binary, and documentation archives have been uploaded to:
-
-https://dist.apache.org/repos/dist/dev/tapestry
-
+ https://dist.apache.org/repos/dist/dev/tapestry
and the Maven artifacts staged to:
-https://repository.apache.org/content/repositories/staging
-
+
https://repository.apache.org/content/repositories/staging/org/apache/tapestry/
Please examine these files to determine if the new release, 5.x, is ready.
+I've also created a 5.x tag in Git:
-I've also created a 5.x tag in Git:
-
-
-https://git-wip-us.apache.org/repos/asf?p=tapestry-5.git;a=log;h=refs/tags/5.x
-
+
https://git-wip-us.apache.org/repos/asf?p=tapestry-5.git;a=log;h=refs/tags/5.x
Vote will run for three days and requires majority approval from
the PMC: At least 3 binding +1 votes and more positive than
negative binding votes.
-
-On a successful vote, I'll release the Maven artifacts, the archives,
+On a successful vote, I'll release the Maven artifacts, the archives,
and make the necessary updates to JIRA and the Tapestry site.
-
Only votes cast by Tapestry PMC members are binding, but input
from the community is highly valued. Please indicate whether your
vote is binding or not after your full name (as it will appear in
-the end-of-vote summary).</pre>
+the end-of-vote summary).]]></script>
</div></div><p>I often embellish this template with extra
detail.</p><p>Lately, I append a text version of the JIRA release notes as
well.</p></div>
</div>
