Repository: incubator-freemarker-site Updated Branches: refs/heads/asf-site a40043241 -> 17589eaa2
Updated committer-howto Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/commit/17589eaa Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/tree/17589eaa Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/diff/17589eaa Branch: refs/heads/asf-site Commit: 17589eaa2a8ce2e32473a00020757532e526e768 Parents: a400432 Author: ddekany <[email protected]> Authored: Wed Mar 15 22:26:48 2017 +0100 Committer: ddekany <[email protected]> Committed: Wed Mar 15 22:26:48 2017 +0100 ---------------------------------------------------------------------- committer-howto.html | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/17589eaa/committer-howto.html ---------------------------------------------------------------------- diff --git a/committer-howto.html b/committer-howto.html index 3e6803e..7eaa917 100644 --- a/committer-howto.html +++ b/committer-howto.html @@ -14,7 +14,7 @@ <link rel="canonical" href="http://freemarker.org/committer-howto.html";> <link rel="icon" href="favicon.png" type="image/png"> <link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono"> -<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1488814460551"> +<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489613156790"> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), @@ -35,8 +35,8 @@ ga('send', 'pageview'); <div class="content-wrapper"> <div id="table-of-contents-wrapper" class="col-left"> <script>var breadcrumb = ["Apache FreeMarker","Community","Committer how-to"];</script> - <script src="toc.js?1488814460551"></script> - <script src="docgen-resources/main.min.js?1488814460551"></script> + <script src="toc.js?1489613156790"></script> + <script src="docgen-resources/main.min.js?1489613156790"></script> </div> <div class="col-right"><div class="page-content"><div class="page-title"><div class="title-wrapper"> <h1 class="content-header header-section1" id="committer-howto" itemprop="headline">Committer how-to</h1> @@ -183,8 +183,8 @@ ga('send', 'pageview'); <p>Releases with non-trivial changes should have at least one Release Candidate (RC01) release, which is legally a normal release (not just a internal/developer one), and is promoted for - at least 1 month on our web page. These are there differences to a - final release:</p> + at least 1 month on our web page. The differences to a final + release are these:</p> <ul> <li> @@ -205,22 +205,28 @@ ga('send', 'pageview'); project (src tar.gz). For the convenience of users the release is also accompanied by compiled binaries (bin tar.gz, which also contains the documentation). Both artifacts are downloadable from - the Apache Software Foundation, as usual</p> + the Apache Software Foundation, as usual.</p> </li> <li> <p>The same two artifacts should also be released (uploaded for download) on <a href="https://sourceforge.net/projects/freemarker/";>https://sourceforge.net/projects/freemarker/</a>. - We add a note there to the indicate that the canonical download is - the one from Apache.</p> + We add a note there to indicate that the canonical download is the + one from Apache.</p> </li> <li> <p>Releases should have a usual jar artifact, an src artifact - and javadoc artifact either in the Apache Maven staging reposotory + and javadoc artifact either in the Apache Maven staging repository (for RC-s), or in the Maven Central Repository (for finals).</p> </li> + + <li> + <p>In the 2.3.x branch, we release two products, the normal and + the GAE (Google App Engine) version. Hence when executing the + release steps, you do many of them twice.</p> + </li> </ul> <p>The steps of making a release:</p> @@ -245,7 +251,19 @@ ga('send', 'pageview'); </li> <li> - <p>Ensure this is up to date: + <p>Compare the jar to the earlier stable release for API + compatibility issues (both source and binary level). So far we + have used <a href="https://lvc.github.io/japi-compliance-checker/";>"Java + API Compliance Checker" (JAPICC)</a> with these + arguments: <code class="inline-code">-keep-internal -skip-internal-types \._ -l + FreeMarker <em class="code-color">old</em>.jar + <em class="code-color">new</em>.jar</code>. Note that it's prone + to generate false alarms, so simply review each problems and + decide which is real.</p> + </li> + + <li> + <p>Ensure that this is up to date: https://dist.apache.org/repos/dist/<em>{dev,release}</em>/incubator/freemarker/KEY</p> </li> @@ -641,7 +659,7 @@ ga('send', 'pageview'); </div> <div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="index.html">What is FreeMarker?</a></li><li><a href="freemarkerdownload.html">Download</a></li><li><a href="docs/app_versions.html">Version history</a></li><li><a href="history.html">About us</a></li><li><a itemprop="license" href="docs/app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/";>Try template online</a></li><li><a href="docs/dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="docs/ref_directive_alphaidx.html">#directives</a></li><li><a href="docs/ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="docs/ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href="https://github.com/apach e/incubator-freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker";>Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/";>Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker";>Ask a question</a></li><li><a href="mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/apache/incubator-freemarker";>GitHub</a></li><li><a class="twitter" href="https://twitter.com/freemarker";>Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker";>Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/"; rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated"> Last generated: -<time itemprop="dateModified" datetime="2017-03-06T15:34:20Z" title="Monday, March 6, 2017 3:34:20 PM GMT">2017-03-06 15:34:20 GMT</time> </p> +<time itemprop="dateModified" datetime="2017-03-15T21:25:56Z" title="Wednesday, March 15, 2017 9:25:56 PM GMT">2017-03-15 21:25:56 GMT</time> </p> <p class="copyright"> © <span itemprop="copyrightYear">1999</span>â2017 <a itemtype="http://schema.org/Organization"; itemprop="copyrightHolder" href="http://apache.org/";>The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>
