Author: crossley
Date: Wed Nov 28 02:45:20 2012
New Revision: 1414513
URL: http://svn.apache.org/viewvc?rev=1414513&view=rev
Log:
Adjust the release docs to utilise our new dist SVN and SvnPubSub.
Modified:
forrest/site/dtdx/document-v13.pdf
forrest/site/dtdx/document-v20.pdf
forrest/site/procedures/release/How_to_release.html
forrest/site/procedures/release/test_and_vote_on_rel_cand.txt
Modified: forrest/site/dtdx/document-v13.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.pdf?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/dtdx/document-v20.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.pdf?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/procedures/release/How_to_release.html
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/How_to_release.html?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
--- forrest/site/procedures/release/How_to_release.html (original)
+++ forrest/site/procedures/release/How_to_release.html Wed Nov 28 02:45:20 2012
@@ -801,18 +801,20 @@ document.write("Last Published: " + docu
<div class="section">
<p>
The SVN at
- <a href="https://svn.apache.org/repos/asf/forrest/dist/">https://svn.apache.org/repos/asf/forrest/dist/</a>
- holds some html files and other files that form the distribution
- website. This is checked out on the server at
- /www/www.apache.org/dist/forrest
+ <a href="https://dist.apache.org/repos/dist/release/forrest/">https://dist.apache.org/repos/dist/release/forrest/</a>
+ holds some html files for the header and footer of the mirrors, and the other files that form the distribution.
+ This is automatically reflected by
+ <a href="http://www.apache.org/dev/cms.html#svnpubsub">SvnPubSub</a> on the server to
+ /www/www.apache.org/dist/forrest directory, which is our public distribution space.
</p>
<p>
- Note that the actual release artefacts are not stored in SVN.
+ Ensure that the KEYS file is synchronised with the copy in Forrest svn
+ trunk and commit the changes.
</p>
<p>
- Ensure that the KEYS file is synchronised with the copy in Forrest svn
- trunk and commit the changes. Do ssh to the server and 'svn up' in that
- directory.
+ Ensure that our "dist/dev" SVN area at
+ <a href="https://dist.apache.org/repos/dist/dev/forrest/">https://dist.apache.org/repos/dist/dev/forrest/</a>
+ is ready to hold the release candidate for voting.
</p>
</div>
@@ -1367,8 +1369,9 @@ where
<ol>
<li>
- Upload the release candidate packages and signatures to your committer's webspace.
- </li>
+ Upload the release candidate packages and signatures to the dist/dev/forrest SVN.
+ See <a href="#PrepDistSvn">notes</a>.
+ </li>
<li>
<p>
@@ -1396,7 +1399,7 @@ where
<li>Encourage people to build some difficult sites.</li>
-<li>Remind people about how long remains for testing.</li>
+<li>Occasionally remind people about how much time remains for testing.</li>
</ul>
</li>
@@ -1438,11 +1441,6 @@ where
<ol>
<li>
- Remove the release candidate packages from your public_html
- directory.
- </li>
-
-<li>
<p>
If there have been changes to the trunk since the branch was
created, then merge trunk to branch. Remember to use a proper commit message
@@ -1661,16 +1659,15 @@ svn mkdir plugins/0.10</pre>
<li>
<p>
- Use scp to upload the release: the *.tar.gz, the *.zip, the *.asc
- and *.md5 files, and the RELEASE-NOTES-0.9.txt to people.apache.org
- at /www/www.apache.org/ dist/forrest/ directory.
+ Use 'svn move' to upload the release: i.e. move the *.tar.gz, the *.zip, the *.asc
+ and *.md5 files, and the RELEASE-NOTES-0.9.txt from dist/dev/forrest SVN to dist/release/forrest SVN.
+ Note that SvnPubSub will automatically publish the release.
</p>
<p>
- Ensure correct file permissions by executing <span class="codefrag">'chgrp forrest
- *'</span> then <span class="codefrag">'chmod g+w *'</span> in that directory.
- Each PMC member has a server account and belongs to the forrest
- group.
+ Leave the previous distribution there as well as the new one, until after
+ the announcement (because mirrors.html cannot be updated until most
+ mirrors have received the release).
</p>
<p>
@@ -1686,21 +1683,7 @@ svn mkdir plugins/0.10</pre>
<a href="http://www.apache.org/dev/#releases">http://www.apache.org/dev/#releases</a>
</p>
-
-<p>
- Leave the previous dist there as well as the new one, until after
- the announcement (because mirrors.html cannot be updated until most
- mirrors have received the release).
- </p>
-
-<div class="note">
-<div class="label">Note</div>
-<div class="content">
- The other files there (HEADER.html README.html LICENSE.txt KEYS) are
- all automatically updated from the SVN:forrest/dist/ repository
- (<a href="#PrepDistSvn">explained</a> above).
- </div>
-</div>
+
</li>
<li>
@@ -1842,8 +1825,8 @@ svn mkdir plugins/0.10</pre>
<li>
<p>
- One day later, remove old dist files from the /www/www.apache.org/dist/forrest/
- directory. They have already been automatically archived at
+ One day later, remove old distribution files from the dist/release/forrest SVN.
+ They have already been automatically archived at
archive.apache.org/dist/forrest/
</p>
Modified: forrest/site/procedures/release/test_and_vote_on_rel_cand.txt
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/test_and_vote_on_rel_cand.txt?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
--- forrest/site/procedures/release/test_and_vote_on_rel_cand.txt (original)
+++ forrest/site/procedures/release/test_and_vote_on_rel_cand.txt Wed Nov 28 02:45:20 2012
@@ -9,7 +9,7 @@ test it on your projects, especially on
systems and Java version. See testing hints below.
Download the release candidate and supporting files:
-http://people.apache.org/~[### your apache ID ###]/temp/forrest-###09###-rc1/
+https://dist.apache.org/repos/dist/dev/forrest/
For Windows get *.zip (md5sum ################################)
For UNIX get *.tar.gz (md5sum ################################)
Date: Wed Nov 28 02:45:20 2012
New Revision: 1414513
URL: http://svn.apache.org/viewvc?rev=1414513&view=rev
Log:
Adjust the release docs to utilise our new dist SVN and SvnPubSub.
Modified:
forrest/site/dtdx/document-v13.pdf
forrest/site/dtdx/document-v20.pdf
forrest/site/procedures/release/How_to_release.html
forrest/site/procedures/release/test_and_vote_on_rel_cand.txt
Modified: forrest/site/dtdx/document-v13.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.pdf?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/dtdx/document-v20.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.pdf?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/procedures/release/How_to_release.html
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/How_to_release.html?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
--- forrest/site/procedures/release/How_to_release.html (original)
+++ forrest/site/procedures/release/How_to_release.html Wed Nov 28 02:45:20 2012
@@ -801,18 +801,20 @@ document.write("Last Published: " + docu
<div class="section">
<p>
The SVN at
- <a href="https://svn.apache.org/repos/asf/forrest/dist/">https://svn.apache.org/repos/asf/forrest/dist/</a>
- holds some html files and other files that form the distribution
- website. This is checked out on the server at
- /www/www.apache.org/dist/forrest
+ <a href="https://dist.apache.org/repos/dist/release/forrest/">https://dist.apache.org/repos/dist/release/forrest/</a>
+ holds some html files for the header and footer of the mirrors, and the other files that form the distribution.
+ This is automatically reflected by
+ <a href="http://www.apache.org/dev/cms.html#svnpubsub">SvnPubSub</a> on the server to
+ /www/www.apache.org/dist/forrest directory, which is our public distribution space.
</p>
<p>
- Note that the actual release artefacts are not stored in SVN.
+ Ensure that the KEYS file is synchronised with the copy in Forrest svn
+ trunk and commit the changes.
</p>
<p>
- Ensure that the KEYS file is synchronised with the copy in Forrest svn
- trunk and commit the changes. Do ssh to the server and 'svn up' in that
- directory.
+ Ensure that our "dist/dev" SVN area at
+ <a href="https://dist.apache.org/repos/dist/dev/forrest/">https://dist.apache.org/repos/dist/dev/forrest/</a>
+ is ready to hold the release candidate for voting.
</p>
</div>
@@ -1367,8 +1369,9 @@ where
<ol>
<li>
- Upload the release candidate packages and signatures to your committer's webspace.
- </li>
+ Upload the release candidate packages and signatures to the dist/dev/forrest SVN.
+ See <a href="#PrepDistSvn">notes</a>.
+ </li>
<li>
<p>
@@ -1396,7 +1399,7 @@ where
<li>Encourage people to build some difficult sites.</li>
-<li>Remind people about how long remains for testing.</li>
+<li>Occasionally remind people about how much time remains for testing.</li>
</ul>
</li>
@@ -1438,11 +1441,6 @@ where
<ol>
<li>
- Remove the release candidate packages from your public_html
- directory.
- </li>
-
-<li>
<p>
If there have been changes to the trunk since the branch was
created, then merge trunk to branch. Remember to use a proper commit message
@@ -1661,16 +1659,15 @@ svn mkdir plugins/0.10</pre>
<li>
<p>
- Use scp to upload the release: the *.tar.gz, the *.zip, the *.asc
- and *.md5 files, and the RELEASE-NOTES-0.9.txt to people.apache.org
- at /www/www.apache.org/ dist/forrest/ directory.
+ Use 'svn move' to upload the release: i.e. move the *.tar.gz, the *.zip, the *.asc
+ and *.md5 files, and the RELEASE-NOTES-0.9.txt from dist/dev/forrest SVN to dist/release/forrest SVN.
+ Note that SvnPubSub will automatically publish the release.
</p>
<p>
- Ensure correct file permissions by executing <span class="codefrag">'chgrp forrest
- *'</span> then <span class="codefrag">'chmod g+w *'</span> in that directory.
- Each PMC member has a server account and belongs to the forrest
- group.
+ Leave the previous distribution there as well as the new one, until after
+ the announcement (because mirrors.html cannot be updated until most
+ mirrors have received the release).
</p>
<p>
@@ -1686,21 +1683,7 @@ svn mkdir plugins/0.10</pre>
<a href="http://www.apache.org/dev/#releases">http://www.apache.org/dev/#releases</a>
</p>
-
-<p>
- Leave the previous dist there as well as the new one, until after
- the announcement (because mirrors.html cannot be updated until most
- mirrors have received the release).
- </p>
-
-<div class="note">
-<div class="label">Note</div>
-<div class="content">
- The other files there (HEADER.html README.html LICENSE.txt KEYS) are
- all automatically updated from the SVN:forrest/dist/ repository
- (<a href="#PrepDistSvn">explained</a> above).
- </div>
-</div>
+
</li>
<li>
@@ -1842,8 +1825,8 @@ svn mkdir plugins/0.10</pre>
<li>
<p>
- One day later, remove old dist files from the /www/www.apache.org/dist/forrest/
- directory. They have already been automatically archived at
+ One day later, remove old distribution files from the dist/release/forrest SVN.
+ They have already been automatically archived at
archive.apache.org/dist/forrest/
</p>
Modified: forrest/site/procedures/release/test_and_vote_on_rel_cand.txt
URL: http://svn.apache.org/viewvc/forrest/site/procedures/release/test_and_vote_on_rel_cand.txt?rev=1414513&r1=1414512&r2=1414513&view=diff
==============================================================================
--- forrest/site/procedures/release/test_and_vote_on_rel_cand.txt (original)
+++ forrest/site/procedures/release/test_and_vote_on_rel_cand.txt Wed Nov 28 02:45:20 2012
@@ -9,7 +9,7 @@ test it on your projects, especially on
systems and Java version. See testing hints below.
Download the release candidate and supporting files:
-http://people.apache.org/~[### your apache ID ###]/temp/forrest-###09###-rc1/
+https://dist.apache.org/repos/dist/dev/forrest/
For Windows get *.zip (md5sum ################################)
For UNIX get *.tar.gz (md5sum ################################)