svn commit: r1726350 - /calcite/site/docs/howto.html

[jh...@apache.org]

Author: jhyde
Date: Sat Jan 23 02:02:58 2016
New Revision: 1726350

URL: http://svn.apache.org/viewvc?rev=1726350&view=rev
Log:
How to announce a release

Modified:
    calcite/site/docs/howto.html

Modified: calcite/site/docs/howto.html
URL: http://svn.apache.org/viewvc/calcite/site/docs/howto.html?rev=1726350&r1=1726349&r2=1726350&view=diff
==============================================================================
--- calcite/site/docs/howto.html (original)
+++ calcite/site/docs/howto.html Sat Jan 23 02:02:58 2016
@@ -1387,6 +1387,11 @@ shortened URLs for the vote proposal and
 <p>After a successful release vote, we need to push the release
 out to mirrors, and other tasks.</p>
 
+<p>Choose a release date.
+This is based on the time when you expect to announce the release.
+This is usually a day after the vote closes.
+Remember that UTC date changes at 4pm Pacific time.</p>
+
 <p>In JIRA, search for
 <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CALCITE%20and%20fixVersion%20%3D%201.5.0%20and%20status%20%3D%20Resolved%20and%20resolution%20%3D%20Fixed">all issues resolved in this release</a>,
 and do a bulk update changing their status to “Closed”,
@@ -1422,9 +1427,9 @@ svn add apache-calcite-X.Y.Z
 <span class="c"># Check in.</span>
 svn ci</code></pre></div>
 
-<p>Svnpubsub will publish to
-https://dist.apache.org/repos/dist/release/calcite and propagate to
-http://www.apache.org/dyn/closer.cgi/calcite within 24 hours.</p>
+<p>Svnpubsub will publish to the
+<a href="https://dist.apache.org/repos/dist/release/calcite">release repo</a> and propagate to the
+<a href="http://www.apache.org/dyn/closer.cgi/calcite">mirrors</a> within 24 hours.</p>
 
 <p>If there are now more than 2 releases, clear out the oldest ones:</p>
 
@@ -1437,9 +1442,16 @@ svn ci</code></pre></div>
 
 <p>Add a release note by copying
 <a href="https://github.com/apache/calcite/blob/master/site/_posts/2015-11-10-release-1.5.0.md">site/_posts/2015-11-10-release-1.5.0.md</a>,
+generate the javadoc and copy to <code>site/target/apidocs</code> and <code>site/target/testapidocs</code>,
 <a href="#publish-the-web-site">publish the site</a>,
 and check that it appears in the contents in <a href="http://localhost:4000/news/">news</a>.</p>
 
+<p>After 24 hours, announce the release by sending an email to
+<a href="https://mail-archives.apache.org/mod_mbox/www-announce/">announce@apache.org</a>.
+You can use
+<a href="https://mail-archives.apache.org/mod_mbox/www-announce/201601.mbox/%3C8DB4C1E5-B322-4A33-8E8F-9858FA6A1119%40apache.org%3E">the 1.6.0 announcement</a>
+as a template. Be sure to include a brief description of the project.</p>
+
 <h2 id="publish-the-web-site">Publishing the web site (for Calcite committers)</h2>
 
 <p>See instructions in