http://git-wip-us.apache.org/repos/asf/polygene-website/blob/538baaf6/content/java/develop/related.html ---------------------------------------------------------------------- diff --git a/content/java/develop/related.html b/content/java/develop/related.html index 3d502cc..d537688 100644 --- a/content/java/develop/related.html +++ b/content/java/develop/related.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Related publications & projects</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="intro.html" title="Introduction" /><link rel="prev" href="state-modeling.html" title="Polygene⢠and state modeling" /><link rel="next" href="tutorials.html" title="Tutorials" /> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Related publications & projects</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="intro.html" title="Introduction" /><link rel="prev" href="state-modeling.html" title="Polygene⢠and state modeling" /><link rel="next" href="tutorials.html" title="Tutorials" /> <!-- favicon --> @@ -66,9 +66,9 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><span xmlns="" href="intro.html">Introduction</span></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.ht ml">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="intro.html#highlights">Highlights</a></span></dt><dt><span class="section"><a href="introduction-background.html">Background</a></span></dt><dt><span class="section"><a href="what-is-cop.html">What is COP?</a></span></dt><dt><span class="section"><a href="what-s-an-object-anyway.html">Whatâs an Object anyway?</a></span></dt><dt><span class="section"><a href="state-modeling.html">Polygene⢠and state modeling</a></span></dt><dt><span class="section"><span xmlns="" href="related.html">Related publications & projects</span></span></dt></dl></div></div><div class="section" title="Related publications & projects"><div class="titlepage"><div><div><h3 class="title"><a id="related"></a>Related publications & projects</h3></div></div></div><p>Polygene⢠addresses a wide ra nge of concepts, the related publications and projects youâll find in this section span accross + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" style="width:80%;height:80%; padding-top:20px;" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><span xmlns="" href="intro.html">Introduction</span></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</ a></span></dt><dt><span class="section"><a href="glossary.html">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="intro.html#highlights">Highlights</a></span></dt><dt><span class="section"><a href="introduction-background.html">Background</a></span></dt><dt><span class="section"><a href="what-is-cop.html">What is COP?</a></span></dt><dt><span class="section"><a href="what-s-an-object-anyway.html">Whatâs an Object anyway?</a></span></dt><dt><span class="section"><a href="state-modeling.html">Polygene⢠and state modeling</a></span></dt><dt><span class="section"><span xmlns="" href="related.html">Related publications & projects</span></span></dt></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="related"></a>Related publications & projects</h3></div></div></div><p>Pol ygene⢠addresses a wide range of concepts, the related publications and projects youâll find in this section span accross all theses concepts. Please note that this is not an exhaustive list but only some pointers to help you understand which -principles Polygene⢠is based on.</p><div class="section" title="Publications"><div class="titlepage"><div><div><h4 class="title"><a id="_publications"></a>Publications</h4></div></div></div><p>In chronological order, related publications:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p class="simpara"> +principles Polygene⢠is based on.</p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_publications"></a>Publications</h4></div></div></div><p>In chronological order, related publications:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p class="simpara"> <span class="strong"><strong>Object-oriented Software Construction</strong></span> </p><p class="simpara">by Bertrand Meyer - 1988</p><p class="simpara">"<span class="emphasis"><em>The comprehensive reference on all aspects of object technology, from design principles to O-O techniques, Design by Contract, O-O analysis, concurrency, persistence, abstract data types and many more. Written by a pioneer in the field, @@ -162,7 +162,7 @@ information. This simple notion leads to some profound consequences for the desi </p><p class="simpara">by Martin Fowler - WIP</p><p class="simpara">"<span class="emphasis"><em>Capture all changes to an application state as a sequence of events.</em></span>"</p><p class="simpara"><a class="ulink" href="http://martinfowler.com/eaaDev/EventSourcing.html"; target="_top">http://martinfowler.com/eaaDev/EventSourcing.html</a></p></li><li class="listitem"><p class="simpara"> <span class="strong"><strong>Event Collaboration</strong></span> </p><p class="simpara">by Martin Fowler - WIP</p><p class="simpara">"<span class="emphasis"><em>Multiple components work together by communicating with each other by sending events when their internal state -changes.</em></span>"</p><p class="simpara"><a class="ulink" href="http://martinfowler.com/eaaDev/EventCollaboration.html"; target="_top">http://martinfowler.com/eaaDev/EventCollaboration.html</a></p></li></ul></div></div><div class="section" title="Projects"><div class="titlepage"><div><div><h4 class="title"><a id="_projects"></a>Projects</h4></div></div></div><p><span class="emphasis"><em>Pêle-mêle</em></span>, inspiring, inspired, alternatives or simply related:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p class="simpara"> +changes.</em></span>"</p><p class="simpara"><a class="ulink" href="http://martinfowler.com/eaaDev/EventCollaboration.html"; target="_top">http://martinfowler.com/eaaDev/EventCollaboration.html</a></p></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_projects"></a>Projects</h4></div></div></div><p><span class="emphasis"><em>Pêle-mêle</em></span>, inspiring, inspired, alternatives or simply related:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p class="simpara"> <span class="strong"><strong>AspectJ</strong></span> </p><p class="simpara">"<span class="emphasis"><em>An aspect-oriented extension to the Java programming language.</em></span>"</p><p class="simpara"><a class="ulink" href="http://www.eclipse.org/aspectj/"; target="_top">eclipse.org/aspectj</a></p></li><li class="listitem"><p class="simpara"> <span class="strong"><strong>Spring Framework</strong></span>
http://git-wip-us.apache.org/repos/asf/polygene-website/blob/538baaf6/content/java/develop/releasing-apache.html ---------------------------------------------------------------------- diff --git a/content/java/develop/releasing-apache.html b/content/java/develop/releasing-apache.html index 63f0e2d..1754bf7 100644 --- a/content/java/develop/releasing-apache.html +++ b/content/java/develop/releasing-apache.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Releasing Polygeneâ¢</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="tutorials.html" title="Tutorials" /><link rel="prev" href="community-docs.html" title="Polygene⢠Documentation" /><link rel="next" href="javadocs.html" title="Javadoc" /> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Releasing Polygeneâ¢</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="tutorials.html" title="Tutorials" /><link rel="prev" href="community-docs.html" title="Polygene⢠Documentation" /><link rel="next" href="javadocs.html" title="Javadoc" /> <!-- favicon --> @@ -66,10 +66,10 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><span xmlns="" href="tutorials.html">Tutorials</span></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.ht ml">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="tutorials.html#_overview">Overview</a></span></dt><dt><span class="section"><a href="two-minutes-intro.html">Polygene⢠in 2 minutes</a></span></dt><dt><span class="section"><a href="ten-minutes-intro.html">Polygene⢠in 10 minutes</a></span></dt><dt><span class="section"><a href="thirty-minutes-intro.html">Polygene⢠in 30 minutes</a></span></dt><dt><span class="section"><a href="howto-depend-on-polygene.html">Depend on Polygeneâ¢</a></span></dt><dt><span class="section"><a href="howto-assemble-application.html">Assemble an Application</a></span></dt><dt><span class="section"><a href="tut-composites.html">Transient Composites Tutorial</a></span></dt><dt><span class="section"><a href="tut-services.html">Services Composites Tutorial</a></span></dt><dt><span class="section"><a href="howto-contextual-fragments.html">Use contextual fragments</a></span></dt><dt><span class="section"><a href="howto-leverage-properties.html">Leverage Properties</a></span></dt><dt><span class="section"><a href="howto-create-constraint.html">Create a Constraint</a></span></dt><dt><span class="section"><a href="howto-create-concern.html">Create a Concern</a></span></dt><dt><span class="section"><a href="howto-create-sideeffect.html">Create a SideEffect</a></span></dt><dt><span class="section"><a href="howto-create-entity.html">Create an Entity</a></span></dt><dt><span class="section"><a href="howto-configure-service.html">Configure a Service</a></span></dt><dt><span class="section"><a href="howto-invocation-annotation.html">Use @Invocation</a></span></dt><dt><span class="section"><a href="build-system.html">Polygene⢠Build System</a></span></dt><dt><span class="section"><a href="community-docs.html">Polygene⢠Documentation</a></span></dt><dt><span class="section"><span xmlns= "" href="releasing-apache.html">Releasing Polygeneâ¢</span></span></dt></dl></div></div><div class="section" title="Releasing Polygeneâ¢"><div class="titlepage"><div><div><h3 class="title"><a id="releasing-apache"></a>Releasing Polygeneâ¢</h3></div></div></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>You need a unix-like environment to actually perform the release process. + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" style="width:80%;height:80%; padding-top:20px;" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><span xmlns="" href="tutorials.html">Tutorials</span></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><a href="samples.html">Samples</a></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</ a></span></dt><dt><span class="section"><a href="glossary.html">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="tutorials.html#_overview">Overview</a></span></dt><dt><span class="section"><a href="two-minutes-intro.html">Polygene⢠in 2 minutes</a></span></dt><dt><span class="section"><a href="ten-minutes-intro.html">Polygene⢠in 10 minutes</a></span></dt><dt><span class="section"><a href="thirty-minutes-intro.html">Polygene⢠in 30 minutes</a></span></dt><dt><span class="section"><a href="howto-depend-on-polygene.html">Depend on Polygeneâ¢</a></span></dt><dt><span class="section"><a href="howto-assemble-application.html">Assemble an Application</a></span></dt><dt><span class="section"><a href="tut-composites.html">Transient Composites Tutorial</a></span></dt><dt><span class="section"><a href="tut-services.html">S ervices Composites Tutorial</a></span></dt><dt><span class="section"><a href="howto-contextual-fragments.html">Use contextual fragments</a></span></dt><dt><span class="section"><a href="howto-leverage-properties.html">Leverage Properties</a></span></dt><dt><span class="section"><a href="howto-create-constraint.html">Create a Constraint</a></span></dt><dt><span class="section"><a href="howto-create-concern.html">Create a Concern</a></span></dt><dt><span class="section"><a href="howto-create-sideeffect.html">Create a SideEffect</a></span></dt><dt><span class="section"><a href="howto-create-entity.html">Create an Entity</a></span></dt><dt><span class="section"><a href="howto-configure-service.html">Configure a Service</a></span></dt><dt><span class="section"><a href="howto-invocation-annotation.html">Use @Invocation</a></span></dt><dt><span class="section"><a href="build-system.html">Polygene⢠Build System</a></span></dt><dt><span class="section"><a href="community-docs.html">Polygen e⢠Documentation</a></span></dt><dt><span class="section"><span xmlns="" href="releasing-apache.html">Releasing Polygeneâ¢</span></span></dt></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="releasing-apache"></a>Releasing Polygeneâ¢</h3></div></div></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>You need a unix-like environment to actually perform the release process. This tutorial is known to work on Linux and Mac.</p></div><p>This tutorial is intended for Apache Polygene⢠commiters who want to release a new version of Apache Polygene⢠(Java Edition) at The Apache Software Foundation. It describes the tools and processes of a typical release.</p><p>It is intended to be a recommendation of best practices for the Apache Polygene⢠project. -The instructions provided here are consistent with, but not a replacement for the <a class="ulink" href="https://www.apache.org/dev/release.html"; target="_top">ASF Release Guidelines</a>.</p><div class="section" title="TL;DR"><div class="titlepage"><div><div><h4 class="title"><a id="_tl_dr"></a>TL;DR</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> +The instructions provided here are consistent with, but not a replacement for the <a class="ulink" href="https://www.apache.org/dev/release.html"; target="_top">ASF Release Guidelines</a>.</p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_tl_dr"></a>TL;DR</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"> Build and publish/stage release candidate bits </li><li class="listitem"> VOTE thread @@ -77,8 +77,8 @@ VOTE thread NO: clean things up </li><li class="listitem"> YES: promote the release candidate bits as final and update all properties -</li></ul></div></div><div class="section" title="Preparing a release"><div class="titlepage"><div><div><h4 class="title"><a id="_preparing_a_release"></a>Preparing a release</h4></div></div></div><div class="section" title="Select a Release Manager"><div class="titlepage"><div><div><h5 class="title"><a id="_select_a_release_manager"></a>Select a Release Manager</h5></div></div></div><p>A Polygene committer (normally one of the development team) should post an email to the development list proposing that a release be made and nominating a release manager. -Typically, the proposer volunteers as the release manager and it passes by <a class="ulink" href="https://www.apache.org/foundation/glossary.html#LazyConsensus"; target="_top">lazy consensus</a>.</p></div><div class="section" title="Clone/Checkout all repositories"><div class="titlepage"><div><div><h5 class="title"><a id="_clone_checkout_all_repositories"></a>Clone/Checkout all repositories</h5></div></div></div><p>Clone/checkout all needed repositories, next to each other:</p><pre class="programlisting brush: shell">mkdir polygene-repos +</li></ul></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_preparing_a_release"></a>Preparing a release</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_select_a_release_manager"></a>Select a Release Manager</h5></div></div></div><p>A Polygene committer (normally one of the development team) should post an email to the development list proposing that a release be made and nominating a release manager. +Typically, the proposer volunteers as the release manager and it passes by <a class="ulink" href="https://www.apache.org/foundation/glossary.html#LazyConsensus"; target="_top">lazy consensus</a>.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_clone_checkout_all_repositories"></a>Clone/Checkout all repositories</h5></div></div></div><p>Clone/checkout all needed repositories, next to each other:</p><pre class="programlisting brush: shell">mkdir polygene-repos cd polygene-repos git clone https://git-wip-us.apache.org/repos/asf/polygene-java.git polygene-java git clone https://git-wip-us.apache.org/repos/asf/polygene-website.git polygene-website @@ -99,25 +99,25 @@ cd ..</pre><p>You should then get the following directory tree:</p><pre class="p âââ dev | âââ polygene # Releases candidate distributions âââ release - âââ polygene # Releases distributions</pre><div class="tip" title="Tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>From now on, all command line snippets start from the <code class="literal">polygene-repos</code> directory.</p></div></div><div class="section" title="Build Apache Polygene⢠(Java Edition)"><div class="titlepage"><div><div><h5 class="title"><a id="_build_apache_polygene_java_edition"></a>Build Apache Polygene⢠(Java Edition)</h5></div></div></div><p>Ensure you can test, build Apache Polygene⢠(Java Edition), including the documentation minisite generation using Asciidoc and artifact signing.</p><p>Here is what should pass before going further:</p><pre class="programlisting brush: shell">cd polygene-java + âââ polygene # Releases distributions</pre><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>From now on, all command line snippets start from the <code class="literal">polygene-repos</code> directory.</p></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_build_apache_polygene_java_edition"></a>Build Apache Polygene⢠(Java Edition)</h5></div></div></div><p>Ensure you can test, build Apache Polygene⢠(Java Edition), including the documentation minisite generation using Asciidoc and artifact signing.</p><p>Here is what should pass before going further:</p><pre class="programlisting brush: shell">cd polygene-java git checkout develop -./gradlew -Dversion="<RELEASE-VERSION>" checkDistributions</pre><p>See the <a class="link" href="build-system.html" title="Polygene⢠Build System">Build System</a> tutorial for details.</p><div class="important" title="Important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Also ensure that the <a class="ulink" href="https://builds.apache.org/view/P/view/Polygene/job/Polygene(JavaEdition)-develop-java8-checkDists/" target="_top"><code class="literal">checkDists</code></a> CI build is passing.</p></div></div><div class="section" title="Install Jekyll"><div class="titlepage"><div><div><h5 class="title"><a id="_install_jekyll"></a>Install Jekyll</h5></div></div></div><p>Moreover, you will need to have a valid <a class="ulink" href="http://jekyllrb.com/"; target="_top">Jekyll</a> installation as the Apache Polygene⢠<a class="ulink" href="https://polygene.apache.org/"; target="_top">website</a> is generated using it.</p></div><div class="se ction" title="Setup git flow"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_git_flow"></a>Setup git flow</h5></div></div></div><p><code class="literal">git-flow</code> is a git extension that add git commands to easily use the git flow branching model the Apache Polygene⢠project follows. -See the <a class="ulink" href="https://github.com/nvie/gitflow/wiki/Installation"; target="_top">installation instructions</a>.</p></div><div class="section" title="Setup git signing"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_git_signing"></a>Setup git signing</h5></div></div></div><p>Ensure you can sign git tags.</p><pre class="programlisting brush: shell">git config --global user.signingkey <YOUR-PGP-ID></pre><p>See the <a class="ulink" href="https://git-scm.com/book/tr/v2/Git-Tools-Signing-Your-Work"; target="_top">Git Tools - Signing Your Work</a> section of the Git book.</p></div><div class="section" title="Setup Apache Nexus credentials"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_apache_nexus_credentials"></a>Setup Apache Nexus credentials</h5></div></div></div><p>See the Apache <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html"; target="_top">Publishing Maven Artifacts</a> guide and the Apache Pol ygene⢠(Java Edition) <a class="link" href="build-system.html" title="Polygene⢠Build System">Build System</a> tutorial.</p></div><div class="section" title="Setup nodejs and NPM registry credentials"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_nodejs_and_npm_registry_credentials"></a>Setup nodejs and NPM registry credentials</h5></div></div></div><p>First, <a class="ulink" href="https://nodejs.org/en/download/"; target="_top">install NodeJS</a>.</p><p>If you donât have a <code class="literal">npmjs.org</code> user yet, create one now:</p><pre class="programlisting brush: shell">npm adduser</pre><p>If your <code class="literal">npmjs.org</code> user is not registered as a maintainer for the +./gradlew -Dversion="<RELEASE-VERSION>" checkDistributions</pre><p>See the <a class="link" href="build-system.html" title="Polygene⢠Build System">Build System</a> tutorial for details.</p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Also ensure that the <a class="ulink" href="https://builds.apache.org/view/P/view/Polygene/job/Polygene(JavaEdition)-develop-java8-checkDists/" target="_top"><code class="literal">checkDists</code></a> CI build is passing.</p></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_install_jekyll"></a>Install Jekyll</h5></div></div></div><p>Moreover, you will need to have a valid <a class="ulink" href="http://jekyllrb.com/"; target="_top">Jekyll</a> installation as the Apache Polygene⢠<a class="ulink" href="https://polygene.apache.org/"; target="_top">website</a> is generated using it.</p></div><div class="section"><div class="titlepage"><div><div>< h5 class="title"><a id="_setup_git_flow"></a>Setup git flow</h5></div></div></div><p><code class="literal">git-flow</code> is a git extension that add git commands to easily use the git flow branching model the Apache Polygene⢠project follows. +See the <a class="ulink" href="https://github.com/nvie/gitflow/wiki/Installation"; target="_top">installation instructions</a>.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_git_signing"></a>Setup git signing</h5></div></div></div><p>Ensure you can sign git tags.</p><pre class="programlisting brush: shell">git config --global user.signingkey <YOUR-PGP-ID></pre><p>See the <a class="ulink" href="https://git-scm.com/book/tr/v2/Git-Tools-Signing-Your-Work"; target="_top">Git Tools - Signing Your Work</a> section of the Git book.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_apache_nexus_credentials"></a>Setup Apache Nexus credentials</h5></div></div></div><p>See the Apache <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html"; target="_top">Publishing Maven Artifacts</a> guide and the Apache Polygene⢠(Java Edition) <a class="link" href="build-system.html" title="Polygene⢠Build System">Build System</a> tutorial.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_setup_nodejs_and_npm_registry_credentials"></a>Setup nodejs and NPM registry credentials</h5></div></div></div><p>First, <a class="ulink" href="https://nodejs.org/en/download/"; target="_top">install NodeJS</a>.</p><p>If you donât have a <code class="literal">npmjs.org</code> user yet, create one now:</p><pre class="programlisting brush: shell">npm adduser</pre><p>If your <code class="literal">npmjs.org</code> user is not registered as a maintainer for the <a class="ulink" href="https://www.npmjs.com/package/generator-polygene"; target="_top">generator-polygene</a> package, ask for the privilege on -<code class="literal">[email protected]</code>.</p></div><div class="section" title="Update the KEYS files if needed."><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_literal_keys_literal_files_if_needed"></a>Update the <code class="literal">KEYS</code> files if needed.</h5></div></div></div><p>The reference <code class="literal">KEYS</code> file can be found at the <code class="literal">polygene-java</code> repositoryâs root, that is <code class="literal">polygene-java/KEYS</code>. +<code class="literal">[email protected]</code>.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_literal_keys_literal_files_if_needed"></a>Update the <code class="literal">KEYS</code> files if needed.</h5></div></div></div><p>The reference <code class="literal">KEYS</code> file can be found at the <code class="literal">polygene-java</code> repositoryâs root, that is <code class="literal">polygene-java/KEYS</code>. Ensure that it contains your public key.</p><p>Next, diff it against the ones present in the <code class="literal">dev</code> and <code class="literal">release</code> distribution areas:</p><pre class="programlisting brush: shell">diff polygene-java/KEYS polygene-dist/dev/polygene/KEYS diff polygene-java/KEYS polygene-dist/release/polygene/KEYS</pre><p>And update them if needed:</p><pre class="programlisting brush: shell">cp polygene-java/KEYS polygene-dist/dev/polygene/KEYS cp polygene-java/KEYS polygene-dist/release/polygene/KEYS cd polygene-dist/dev/polygene svn add dev/polygene/KEYS release/polygene/KEYS -svn commit -m "polygene: updating Polygene KEYS"</pre></div></div><div class="section" title="Creating a Release Candidate"><div class="titlepage"><div><div><h4 class="title"><a id="_creating_a_release_candidate"></a>Creating a Release Candidate</h4></div></div></div><div class="section" title="Resolve JIRA issues"><div class="titlepage"><div><div><h5 class="title"><a id="_resolve_jira_issues"></a>Resolve JIRA issues</h5></div></div></div><p>Resolve all issues on that version! -They can be resolved by:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> +svn commit -m "polygene: updating Polygene KEYS"</pre></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_creating_a_release_candidate"></a>Creating a Release Candidate</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_resolve_jira_issues"></a>Resolve JIRA issues</h5></div></div></div><p>Resolve all issues on that version! +They can be resolved by:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"> fixing </li><li class="listitem"> marking them as <code class="literal">INVALID</code> or <code class="literal">WONTFIX</code> </li><li class="listitem"> changing their fix version to another unreleased version -</li></ul></div><p>See the <a class="ulink" href="https://issues.apache.org/jira/browse/POLYGENE"; target="_top">POLYGENE</a> project on JIRA.</p></div><div class="section" title="Prepare Release-Notes"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_release_notes"></a>Prepare Release-Notes</h5></div></div></div><p>Apache Polygene⢠release-notes are generated from JIRA issues.</p><p>Open the target Polygene⢠versionâs release-notes in <a class="ulink" href="https://issues.apache.org/jira/browse/POLYGENE/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel"; target="_top">JIRA</a> and review them.</p><p>JIRA can produces release-notes as HTML or plain-text. +</li></ul></div><p>See the <a class="ulink" href="https://issues.apache.org/jira/browse/POLYGENE"; target="_top">POLYGENE</a> project on JIRA.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_release_notes"></a>Prepare Release-Notes</h5></div></div></div><p>Apache Polygene⢠release-notes are generated from JIRA issues.</p><p>Open the target Polygene⢠versionâs release-notes in <a class="ulink" href="https://issues.apache.org/jira/browse/POLYGENE/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel"; target="_top">JIRA</a> and review them.</p><p>JIRA can produces release-notes as HTML or plain-text. Set it up to generate plain-text release-notes.</p><p>We will need these in several formats. Starting from the plain-text one we will generate the others.</p><p>First save the text-plain release-notes in a file named <code class="literal">apache-polygene-java-<RELEASE-VERSION>-release-notes.txt</code>. A good place for this file would be in the <code class="literal">polygene-repos</code> directory created earlier, alongside all repositories.</p><p>Convert to Asciidoc:</p><pre class="programlisting brush: shell">cat "apache-polygene-java-<RELEASE-VERSION>-release-notes.txt" | \ @@ -129,8 +129,8 @@ A good place for this file would be in the <code class="literal">polygene-repos< > "apache-polygene-java-<RELEASE-VERSION>-release-notes.md"</pre><p>You should then have the following files:</p><pre class="programlisting brush: shell">. âââ apache-polygene-java-<RELEASE-VERSION>-release-notes.txt âââ apache-polygene-java-<RELEASE-VERSION>-release-notes.adoc -âââ apache-polygene-java-<RELEASE-VERSION>-release-notes.md</pre><p>We will use them later.</p></div><div class="section" title="Create a RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_create_a_rc_branch"></a>Create a RC branch</h5></div></div></div><p>We use <code class="literal"><RELEASE-VERSION>-RC#</code> where <code class="literal">RELEASE-VERSION</code> is the target release version and <code class="literal">RC#</code> for Release Candidate and an incremental number in case the release process has to be done several times.</p><pre class="programlisting brush: shell">cd polygene-java -git flow release start "<RELEASE-VERSION>-RC#"</pre><p>This will eventually generates a <code class="literal"><RELEASE-VERSION>-RC#</code> tag that we will amend with a <code class="literal"><RELEASE-VERSION></code> signed tag if the vote passes, see below.</p></div><div class="section" title="Audit artifacts and distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_audit_artifacts_and_distributions"></a>Audit artifacts and distributions</h5></div></div></div><p>Make a complete build, deploying maven artifacts locally:</p><pre class="programlisting brush: shell">cd polygene-java +âââ apache-polygene-java-<RELEASE-VERSION>-release-notes.md</pre><p>We will use them later.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_create_a_rc_branch"></a>Create a RC branch</h5></div></div></div><p>We use <code class="literal"><RELEASE-VERSION>-RC#</code> where <code class="literal">RELEASE-VERSION</code> is the target release version and <code class="literal">RC#</code> for Release Candidate and an incremental number in case the release process has to be done several times.</p><pre class="programlisting brush: shell">cd polygene-java +git flow release start "<RELEASE-VERSION>-RC#"</pre><p>This will eventually generates a <code class="literal"><RELEASE-VERSION>-RC#</code> tag that we will amend with a <code class="literal"><RELEASE-VERSION></code> signed tag if the vote passes, see below.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_audit_artifacts_and_distributions"></a>Audit artifacts and distributions</h5></div></div></div><p>Make a complete build, deploying maven artifacts locally:</p><pre class="programlisting brush: shell">cd polygene-java ./gradlew -Dversion="<RELEASE-VERSION>" assemble</pre><p>Review maven artifacts in <code class="literal">distributions/build/stage/maven-binaries</code>.</p><p>Also review the release distributions in <code class="literal">distributions/build/distributions</code> where you should find the following files:</p><pre class="programlisting brush: shell">. âââ apache-polygene-java-<RELEASE-VERSION>-src.tgz âââ apache-polygene-java-<RELEASE-VERSION>-src.tgz.MD5 @@ -139,15 +139,15 @@ git flow release start "<RELEASE-VERSION>-RC#"</pre><p>This will eventuall âââ apache-polygene-java-<RELEASE-VERSION>-src.zip âââ apache-polygene-java-<RELEASE-VERSION>-src.zip.MD5 âââ apache-polygene-java-<RELEASE-VERSION>-src.zip.SHA-512 -âââ apache-polygene-java-<RELEASE-VERSION>-src.zip.asc</pre><p>If any, make the required changes, commit them and iterate.</p></div><div class="section" title="Close the RC branch"><div class="titlepage"><div><div><h5 class="title"><a id="_close_the_rc_branch"></a>Close the RC branch</h5></div></div></div><p>Once you are satisfied with the produced artifacts, close the release candidate branch:</p><pre class="programlisting brush: shell">cd polygene-java -git flow release finish "<RELEASE-VERSION>-RC#"</pre></div><div class="section" title="Checkout the RC tag"><div class="titlepage"><div><div><h5 class="title"><a id="_checkout_the_rc_tag"></a>Checkout the RC tag</h5></div></div></div><p>To build the release candidate bits, we need to checkout the release candidate tag, that will eventually be promoted as a signed release tag, because the Apache Polygene⢠build system generates versionning information based on git metadata.</p><pre class="programlisting brush: shell">cd polygene-java -git checkout "<RELEASE-VERSION>-RC#"</pre></div><div class="section" title="Build RC artifacts and distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_build_rc_artifacts_and_distributions"></a>Build RC artifacts and distributions</h5></div></div></div><pre class="programlisting brush: shell">cd polygene-java -./gradlew -Dversion="<RELEASE-VERSION>" clean assemble</pre></div><div class="section" title="Stage RC maven artifacts"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_rc_maven_artifacts"></a>Stage RC maven artifacts</h5></div></div></div><p>Stage artifacts to <a class="ulink" href="https://repository.apache.org/"; target="_top">repository.apache.org</a> :</p><pre class="programlisting brush: shell">cd polygene-java -./gradlew -Dversion="<RELEASE-VERSION>" uploadArchives</pre><p>Close the staging Nexus repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage"; target="_top">Closing the staged repository</a> guide.</p></div><div class="section" title="Stage NPM registry packages"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_npm_registry_packages"></a>Stage NPM registry packages</h5></div></div></div><p>Publish the new version of the <code class="literal">generator-polygene</code> NPM package tagged as <code class="literal">beta</code>:</p><pre class="programlisting brush: shell">cd polygene-java +âââ apache-polygene-java-<RELEASE-VERSION>-src.zip.asc</pre><p>If any, make the required changes, commit them and iterate.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_close_the_rc_branch"></a>Close the RC branch</h5></div></div></div><p>Once you are satisfied with the produced artifacts, close the release candidate branch:</p><pre class="programlisting brush: shell">cd polygene-java +git flow release finish "<RELEASE-VERSION>-RC#"</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_checkout_the_rc_tag"></a>Checkout the RC tag</h5></div></div></div><p>To build the release candidate bits, we need to checkout the release candidate tag, that will eventually be promoted as a signed release tag, because the Apache Polygene⢠build system generates versionning information based on git metadata.</p><pre class="programlisting brush: shell">cd polygene-java +git checkout "<RELEASE-VERSION>-RC#"</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_build_rc_artifacts_and_distributions"></a>Build RC artifacts and distributions</h5></div></div></div><pre class="programlisting brush: shell">cd polygene-java +./gradlew -Dversion="<RELEASE-VERSION>" clean assemble</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_rc_maven_artifacts"></a>Stage RC maven artifacts</h5></div></div></div><p>Stage artifacts to <a class="ulink" href="https://repository.apache.org/"; target="_top">repository.apache.org</a> :</p><pre class="programlisting brush: shell">cd polygene-java +./gradlew -Dversion="<RELEASE-VERSION>" uploadArchives</pre><p>Close the staging Nexus repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage"; target="_top">Closing the staged repository</a> guide.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_stage_npm_registry_packages"></a>Stage NPM registry packages</h5></div></div></div><p>Publish the new version of the <code class="literal">generator-polygene</code> NPM package tagged as <code class="literal">beta</code>:</p><pre class="programlisting brush: shell">cd polygene-java ./gradlew tools:generator-polygene:prepareTemplateGradleWrapper cd tools/generator-polygene npm publish --tag beta</pre><p>If the release VOTE passes, weâll remove the <code class="literal">beta</code> tag, making the new version available.</p><p>Then open <a class="ulink" href="https://www.npmjs.com/package/generator-polygene"; target="_top">https://www.npmjs.com/package/generator-polygene</a> to check -that the new version was published and is tagged as <code class="literal">beta</code>.</p></div><div class="section" title="Upload RC distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_upload_rc_distributions"></a>Upload RC distributions</h5></div></div></div><p>Source distribution, checksums and signatures must be uploaded to <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">dist.apache.org/repos/dist/dev/polygene</a>. +that the new version was published and is tagged as <code class="literal">beta</code>.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_upload_rc_distributions"></a>Upload RC distributions</h5></div></div></div><p>Source distribution, checksums and signatures must be uploaded to <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">dist.apache.org/repos/dist/dev/polygene</a>. This build created these in the <code class="literal">buid/distributions</code> directory, named <code class="literal">apache-polygene-java-<RELEASE-VERSION>-src*.*</code>. As this release still is a simple candidate, weâll rename them before upload to advertise this in their names.</p><pre class="programlisting brush: shell"># Source ZIP cp "polygene-java/distributions/build/distributions/apache-polygene-java-<RELEASE-VERSION>-src.zip" \ @@ -168,7 +168,7 @@ cp "polygene-java/distributions/build/distributions/apache-polygene-java-<REL cp "polygene-java/distributions/build/distributions/apache-polygene-java-<RELEASE-VERSION>-src.tgz.asc" \ "polygene-dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz.asc"</pre><p>And then upload them:</p><pre class="programlisting brush: shell">cd polygene-dist/dev/polygene svn add * --force -svn commit -m "polygene: upload <RELEASE-VERSION>-RC# to dist/dev/polygene"</pre></div></div><div class="section" title="Run the vote"><div class="titlepage"><div><div><h4 class="title"><a id="_run_the_vote"></a>Run the vote</h4></div></div></div><p>Send a "VOTE" to the <a class="ulink" href="mailto:[email protected]"; target="_top">developer mailing list</a> including links to release artifacts. A VOTE always contains two parts. Send an email to the developer mailing list with the subject line:</p><pre class="programlisting brush: text">[VOTE] Release Polygene (Java Edition) version <RELEASE-VERSION></pre><p>Here is a sample template:</p><pre class="programlisting brush: text">Dear community, +svn commit -m "polygene: upload <RELEASE-VERSION>-RC# to dist/dev/polygene"</pre></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_run_the_vote"></a>Run the vote</h4></div></div></div><p>Send a "VOTE" to the <a class="ulink" href="mailto:[email protected]"; target="_top">developer mailing list</a> including links to release artifacts. A VOTE always contains two parts. Send an email to the developer mailing list with the subject line:</p><pre class="programlisting brush: text">[VOTE] Release Polygene (Java Edition) version <RELEASE-VERSION></pre><p>Here is a sample template:</p><pre class="programlisting brush: text">Dear community, I am happy to start the VOTE thread for Apache Polygene (Java Edition) <RELEASE-VERSION>! @@ -203,8 +203,8 @@ The vote has passed|failed with the following result: +1 (binding): <<list of names>> +1 (non binding): <<list of names>> -I will promote|drop the distributions and artifacts.</pre><p>Votes on whether a package is ready to be released use majority approvalâââi.e., at least three PMC members must vote affirmatively for release, and there must be more positive than negative votes.</p></div><div class="section" title="Verifying a Release Candidate"><div class="titlepage"><div><div><h4 class="title"><a id="_verifying_a_release_candidate"></a>Verifying a Release Candidate</h4></div></div></div><p>In order to verify a Apache Polygene⢠(Java Edition) release candidate youâll need valid <code class="literal">wget</code>, <code class="literal">md5sum</code>, <code class="literal">shasum</code> with support for SHA-5.12, GnuPG and Java JDK >= 7 installations.</p><p>If the setup feels like a chore, keep reading, you probably already have whatâs needed for some of the checks. -A single check is better than none.</p><div class="section" title="Download RC"><div class="titlepage"><div><div><h5 class="title"><a id="_download_rc"></a>Download RC</h5></div></div></div><p>First go downloading the release candidate distributions from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">dist.a.o/repos/dist/dev/polygene</a>. +I will promote|drop the distributions and artifacts.</pre><p>Votes on whether a package is ready to be released use majority approvalâââi.e., at least three PMC members must vote affirmatively for release, and there must be more positive than negative votes.</p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_verifying_a_release_candidate"></a>Verifying a Release Candidate</h4></div></div></div><p>In order to verify a Apache Polygene⢠(Java Edition) release candidate youâll need valid <code class="literal">wget</code>, <code class="literal">md5sum</code>, <code class="literal">shasum</code> with support for SHA-5.12, GnuPG and Java JDK >= 7 installations.</p><p>If the setup feels like a chore, keep reading, you probably already have whatâs needed for some of the checks. +A single check is better than none.</p><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_download_rc"></a>Download RC</h5></div></div></div><p>First go downloading the release candidate distributions from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">dist.a.o/repos/dist/dev/polygene</a>. Including <code class="literal">*.MD5</code>, <code class="literal">*.SHA-512</code> and <code class="literal">*.asc</code> files. Put them in a directory:</p><pre class="programlisting brush: shell">cd polygene-check-rc wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz @@ -214,24 +214,24 @@ wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RE wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.MD5 wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.SHA-512 -wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.asc</pre></div><div class="section" title="Verify RC signatures"><div class="titlepage"><div><div><h5 class="title"><a id="_verify_rc_signatures"></a>Verify RC signatures</h5></div></div></div><p>Verify PGP signatures:</p><pre class="programlisting brush: shell">cd polygene-check-rc +wget https://dist.apache.org/repos/dist/dev/polygene/apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.asc</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_verify_rc_signatures"></a>Verify RC signatures</h5></div></div></div><p>Verify PGP signatures:</p><pre class="programlisting brush: shell">cd polygene-check-rc gpg apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz.asc gpg apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.asc</pre><p>This must output <code class="literal">gpg: Good signature from "Signer Name <[email protected]>"</code> for each distribution.</p><p>Verify MD5 checksum:</p><pre class="programlisting brush: shell">cd polygene-check-rc echo "$(cat apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz.MD5) apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz" | md5sum -c - echo "$(cat apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.MD5) apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip" | md5sum -c -</pre><p>This must output <code class="literal">some-filename: OK</code> for each distribution.</p><p>Verify SHA-512 checksum:</p><pre class="programlisting brush: shell">cd polygene-check-rc echo "$(cat apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz.MD5) apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz" | shasum -a 512 -c - -echo "$(cat apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.MD5) apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip" | shasum -a 512 -c -</pre><p>This also must output <code class="literal">some-filename: OK</code> for each distribution.</p></div><div class="section" title="Verify source distribution"><div class="titlepage"><div><div><h5 class="title"><a id="_verify_source_distribution"></a>Verify source distribution</h5></div></div></div><p>Unpack the source distributions, we will use the <code class="literal">zip</code> distribution here, both should be checked.</p><pre class="programlisting brush: shell">cd polygene-check-rc +echo "$(cat apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip.MD5) apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip" | shasum -a 512 -c -</pre><p>This also must output <code class="literal">some-filename: OK</code> for each distribution.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_verify_source_distribution"></a>Verify source distribution</h5></div></div></div><p>Unpack the source distributions, we will use the <code class="literal">zip</code> distribution here, both should be checked.</p><pre class="programlisting brush: shell">cd polygene-check-rc unzip apache-polygene-java-<RELEASE-VERSION>-RC#-src.zip cd apache-polygene-java-<RELEASE-VERSION>-RC#-src</pre><p><span class="strong"><strong>LICENSE & NOTICE</strong></span></p><p>Review <code class="literal">LICENSE</code> and <code class="literal">NOTICE</code> file(s) ; see the Apacheâs <a class="ulink" href="https://www.apache.org/dev/licensing-howto.html"; target="_top">Licensing Howto</a>.</p><p>Tools like <a class="ulink" href="https://creadur.apache.org/rat/"; target="_top">Apache Ratâ¢</a> and other projects from <a class="ulink" href="https://creadur.apache.org/"; target="_top">Apache Creadurâ¢</a> can come in handy. You can also <code class="literal">grep</code> the whole source tree.</p><p><span class="strong"><strong>Build RC from sources</strong></span></p><pre class="programlisting brush: shell">cd polygene-check-rc/apache-polygene-java-<RELEASE-VERSION>-RC#-src -./gradlew assemble check</pre></div></div><div class="section" title="VOTE passes"><div class="titlepage"><div><div><h4 class="title"><a id="_vote_passes"></a>VOTE passes</h4></div></div></div><div class="section" title="Seal the release"><div class="titlepage"><div><div><h5 class="title"><a id="_seal_the_release"></a>Seal the release</h5></div></div></div><p>Create and sign the release git tag from the unsigned release candidate tag:</p><pre class="programlisting brush: shell">cd polygene-java +./gradlew assemble check</pre></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="_vote_passes"></a>VOTE passes</h4></div></div></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_seal_the_release"></a>Seal the release</h5></div></div></div><p>Create and sign the release git tag from the unsigned release candidate tag:</p><pre class="programlisting brush: shell">cd polygene-java git tag -s "<RELEASE-VERSION>" "<RELEASE-VERSION>-RC#"</pre><p>Push all git changes:</p><pre class="programlisting brush: shell">cd polygene-java git checkout master git push origin master git checkout develop git push origin master -git push origin --tags</pre></div><div class="section" title="Publish bits"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_bits"></a>Publish bits</h5></div></div></div><p>Promote the staged Nexus repository so it gets synched to Maven Central by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#promote"; target="_top">Promoting a repo</a> guide.</p><p>Move the release distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">polygene-dist/dev/polygene</a> to <a class="ulink" href="https://dist.apache.org/repos/dist/release/polygene/"; target="_top">polygene-dist/release/polygene</a>:</p><pre class="programlisting brush: shell">cd polygene-dist +git push origin --tags</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_bits"></a>Publish bits</h5></div></div></div><p>Promote the staged Nexus repository so it gets synched to Maven Central by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#promote"; target="_top">Promoting a repo</a> guide.</p><p>Move the release distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">polygene-dist/dev/polygene</a> to <a class="ulink" href="https://dist.apache.org/repos/dist/release/polygene/"; target="_top">polygene-dist/release/polygene</a>:</p><pre class="programlisting brush: shell">cd polygene-dist # Source ZIP TODO export DIST_DEV_URL="https://dist.apache.org/repos/dist/dev/polygene"; export DIST_RELEASE_URL="https://dist.apache.org/repos/dist/release/polygene"; @@ -259,9 +259,9 @@ svn move "$DIST_DEV_URL/apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz -m "polygene: promoting release <RELEASE-VERSION> distributions" svn move "$DIST_DEV_URL/apache-polygene-java-<RELEASE-VERSION>-RC#-src.tgz.asc" \ "$DIST_RELEASE_URL/apache-polygene-java-<RELEASE-VERSION>-src.tgz.asc" \ - -m "polygene: promoting release <RELEASE-VERSION> distributions"</pre><p>This produces one commit per file but keep svn history and runs fast, without re-uploading the distributions.</p></div><div class="section" title="Wait 24 hours"><div class="titlepage"><div><div><h5 class="title"><a id="_wait_24_hours"></a>Wait 24 hours</h5></div></div></div><p>For mirrors to pick up the new bits.</p></div><div class="section" title="Prepare an announcement"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_an_announcement"></a>Prepare an announcement</h5></div></div></div><p>Coordinate a press release with <a class="ulink" href="mailto:[email protected]"; target="_top">[email protected]</a>.</p><pre class="literallayout">TODO</pre><p>You can reuse the release-notes content from the <code class="literal">txt</code>/<code class="literal">adoc</code>/<code class="literal">md</code> files created earlier.</p><p>This annoucement will be used in a variety of media like email s, websites etc⦠-Start with a text version and once satisfied create at least a Markdown version for the website, see below.</p></div><div class="section" title="Publish generator-polygene to the NPM registry"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_literal_generator_polygene_literal_to_the_npm_registry"></a>Publish <code class="literal">generator-polygene</code> to the NPM registry</h5></div></div></div><pre class="programlisting brush: shell">npm dist-tag rm generator-polygene beta</pre><p>Then open <a class="ulink" href="https://www.npmjs.com/package/generator-polygene"; target="_top">https://www.npmjs.com/package/generator-polygene</a> to check -that the package is not tagged as <code class="literal">beta</code> anymore.</p></div><div class="section" title="Update the Polygene⢠website"><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_polygene_website"></a>Update the Polygene⢠website</h5></div></div></div><p>Generate the documentation and javadoc minisite:</p><pre class="programlisting brush: shell">cd polygene-java + -m "polygene: promoting release <RELEASE-VERSION> distributions"</pre><p>This produces one commit per file but keep svn history and runs fast, without re-uploading the distributions.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_wait_24_hours"></a>Wait 24 hours</h5></div></div></div><p>For mirrors to pick up the new bits.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_prepare_an_announcement"></a>Prepare an announcement</h5></div></div></div><p>Coordinate a press release with <a class="ulink" href="mailto:[email protected]"; target="_top">[email protected]</a>.</p><pre class="literallayout">TODO</pre><p>You can reuse the release-notes content from the <code class="literal">txt</code>/<code class="literal">adoc</code>/<code class="literal">md</code> files created earlier.</p><p>This annoucement will be used in a variety of media like emails, websites etc⦠+Start with a text version and once satisfied create at least a Markdown version for the website, see below.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_publish_literal_generator_polygene_literal_to_the_npm_registry"></a>Publish <code class="literal">generator-polygene</code> to the NPM registry</h5></div></div></div><pre class="programlisting brush: shell">npm dist-tag rm generator-polygene beta</pre><p>Then open <a class="ulink" href="https://www.npmjs.com/package/generator-polygene"; target="_top">https://www.npmjs.com/package/generator-polygene</a> to check +that the package is not tagged as <code class="literal">beta</code> anymore.</p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_update_the_polygene_website"></a>Update the Polygene⢠website</h5></div></div></div><p>Generate the documentation and javadoc minisite:</p><pre class="programlisting brush: shell">cd polygene-java ./gradlew -Dversion="<RELEASE-VERSION>" copyAsfDocumentation</pre><p>This will automatically put all files into the <code class="literal">polygene-website</code> website repository.</p><p>Create a new post on the Polygene⢠website by creating a new Markdown file:</p><pre class="programlisting brush: shell">cd polygene-website touch "src/_posts/YYYY-MM-DD-apache-polygene-java-<RELEASE-VERSION>.md" open !$</pre><p>You can reuse the Markdown formatted announcement content.</p><p>Add the new released version in <code class="literal">polygene-website/content/java/versions.json</code> below the <code class="literal">latest</code> entry:</p><pre class="programlisting brush: js">{ @@ -283,16 +283,16 @@ jekyll build</pre><p>Link <code class="literal">/latest</code> to the latest rel ln -s <RELEASE_VERSION> latest</pre><p>And publish it:</p><pre class="programlisting brush: shell">cd polygene-website git add . git commit -m "update website" -git push</pre></div><div class="section" title="Register the release"><div class="titlepage"><div><div><h5 class="title"><a id="_register_the_release"></a>Register the release</h5></div></div></div><p>Register the new release at <a class="ulink" href="https://reporter.apache.org/"; target="_top">reporter.apache.org</a></p></div><div class="section" title="Announce"><div class="titlepage"><div><div><h5 class="title"><a id="_announce"></a>Announce</h5></div></div></div><p>Finally, send an announcement to <a class="ulink" href="mailto:[email protected]"; target="_top">dev@</a> mailing list. Email announcements should have the subject line:</p><pre class="programlisting brush: text">[ANNOUNCE] Released Polygene (Java Edition) version <RELEASE-VERSION></pre><p>The announcement email should contains the release-notes as text, remember they are in the <code class="literal">apache-polygene-java-<RELEASE-VERSION>-release-notes.txt</code> file you created earlier.</p></div></d iv><div class="section" title="VOTE fails or is cancelled"><div class="titlepage"><div><div><h4 class="title"><a id="_vote_fails_or_is_cancelled"></a>VOTE fails or is cancelled</h4></div></div></div><div class="section" title="Record failure"><div class="titlepage"><div><div><h5 class="title"><a id="_record_failure"></a>Record failure</h5></div></div></div><p>We keep the release candidate git history. +git push</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_register_the_release"></a>Register the release</h5></div></div></div><p>Register the new release at <a class="ulink" href="https://reporter.apache.org/"; target="_top">reporter.apache.org</a></p></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_announce"></a>Announce</h5></div></div></div><p>Finally, send an announcement to <a class="ulink" href="mailto:[email protected]"; target="_top">dev@</a> mailing list. Email announcements should have the subject line:</p><pre class="programlisting brush: text">[ANNOUNCE] Released Polygene (Java Edition) version <RELEASE-VERSION></pre><p>The announcement email should contains the release-notes as text, remember they are in the <code class="literal">apache-polygene-java-<RELEASE-VERSION>-release-notes.txt</code> file you created earlier.</p></div></div><div class="section"><div class="titlepage" ><div><div><h4 class="title"><a id="_vote_fails_or_is_cancelled"></a>VOTE >fails or is cancelled</h4></div></div></div><div class="section"><div >class="titlepage"><div><div><h5 class="title"><a >id="_record_failure"></a>Record failure</h5></div></div></div><p>We keep the >release candidate git history. It can be useful for reviewers to have access to it. Remember, we created a release candidate branch and tags, no signed release tag.</p><pre class="programlisting brush: shell">cd polygene-java git checkout master git push origin master git checkout develop git push origin master -git push origin --tags</pre></div><div class="section" title="Drop RC artifacts and distributions"><div class="titlepage"><div><div><h5 class="title"><a id="_drop_rc_artifacts_and_distributions"></a>Drop RC artifacts and distributions</h5></div></div></div><p>Drop the Nexus staging repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#drop"; target="_top">Dropping a repo</a> guide.</p><p>Drop distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">polygene-dist/dev/polygene</a></p><pre class="programlisting brush: shell">cd polygene-dist/dev/polygene/ +git push origin --tags</pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_drop_rc_artifacts_and_distributions"></a>Drop RC artifacts and distributions</h5></div></div></div><p>Drop the Nexus staging repository by following the <a class="ulink" href="https://www.apache.org/dev/publishing-maven-artifacts.html#drop"; target="_top">Dropping a repo</a> guide.</p><p>Drop distributions, checksums and signatures from <a class="ulink" href="https://dist.apache.org/repos/dist/dev/polygene/"; target="_top">polygene-dist/dev/polygene</a></p><pre class="programlisting brush: shell">cd polygene-dist/dev/polygene/ svn rm "*<RELEASE-VERSION>-RC#*.*" -svn commit -m "polygene: dropping <RELEASE-VERSION>-RC# from dist/dev/polygene as the vote failed/was cancelled"</pre><p>Drop NPM packages:</p><pre class="programlisting brush: shell">npm unpublish generator-polygene@<RELEASE-VERSION></pre></div><div class="section" title="Start over"><div class="titlepage"><div><div><h5 class="title"><a id="_start_over"></a>Start over</h5></div></div></div><p>If a new RC is to be created, restart the process as described above.</p></div></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> +svn commit -m "polygene: dropping <RELEASE-VERSION>-RC# from dist/dev/polygene as the vote failed/was cancelled"</pre><p>Drop NPM packages:</p><pre class="programlisting brush: shell">npm unpublish generator-polygene@<RELEASE-VERSION></pre></div><div class="section"><div class="titlepage"><div><div><h5 class="title"><a id="_start_over"></a>Start over</h5></div></div></div><p>If a new RC is to be created, restart the process as described above.</p></div></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> Copyright © 2015 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/"; target="_blank">Apache License, Version 2.0</a>. <br /><small> Apache Polygene, Polygene, Apache, the Apache feather logo, and the Apache Polygene project logo are trademarks of The Apache Software Foundation.<br /> http://git-wip-us.apache.org/repos/asf/polygene-website/blob/538baaf6/content/java/develop/sample-car-rental.html ---------------------------------------------------------------------- diff --git a/content/java/develop/sample-car-rental.html b/content/java/develop/sample-car-rental.html index 6fcbdd3..61bd4ba 100644 --- a/content/java/develop/sample-car-rental.html +++ b/content/java/develop/sample-car-rental.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Car Rental Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="sample-forum.html" title="Forum Sample" /><link rel="next" href="sample-sql-support.html" title="SQL Support Sample" /> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Car Rental Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="sample-forum.html" title="Forum Sample" /><link rel="next" href="sample-sql-support.html" title="SQL Support Sample" /> <!-- favicon --> @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.ht ml">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-car-rental.html">Car Rental Sample</span></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="Car Rental Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-car-rental"></a>Car Rental Sample</h3></div></div></div><p>Sample of implementation of a Car Rental application implemented as a Servlet + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" style="width:80%;height:80%; padding-top:20px;" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</ a></span></dt><dt><span class="section"><a href="glossary.html">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-car-rental.html">Car Rental Sample</span></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sample-car-rental"></a>Car Rental Sample</h3></div></div></div><p>Sample of implementation of a Car Rental application i mplemented as a Servlet based Webapp packaged as a WAR.</p><p><a class="ulink" href="https://github.com/apache/polygene-java/tree/develop/samples/rental"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> Copyright © 2015 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/"; target="_blank">Apache License, Version 2.0</a>. <br /><small> http://git-wip-us.apache.org/repos/asf/polygene-website/blob/538baaf6/content/java/develop/sample-dci.html ---------------------------------------------------------------------- diff --git a/content/java/develop/sample-dci.html b/content/java/develop/sample-dci.html index abfa5c6..cf0ef9e 100644 --- a/content/java/develop/sample-dci.html +++ b/content/java/develop/sample-dci.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>DCI Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="samples.html" title="Samples" /><link rel="next" href="sample-forum.html" title="Forum Sample" /> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>DCI Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="samples.html" title="Samples" /><link rel="next" href="sample-forum.html" title="Forum Sample" /> <!-- favicon --> @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.ht ml">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><span xmlns="" href="sample-dci.html">DCI Sample</span></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="DCI Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-dci"></a>DCI Sample</h3></div></div></div><p>Sample of how DCI (Data, Context & Interaction) pattern is implemented using + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" style="width:80%;height:80%; padding-top:20px;" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</ a></span></dt><dt><span class="section"><a href="glossary.html">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><span xmlns="" href="sample-dci.html">DCI Sample</span></span></dt><dt><span class="section"><a href="sample-forum.html">Forum Sample</a></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sample-dci"></a>DCI Sample</h3></div></div></div><p>Sample of how DCI (Data, Context & Interaction) pattern is imple mented using Polygene⢠core only.</p><p><a class="ulink" href="https://github.com/apache/polygene-java/tree/develop/samples/dci"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> Copyright © 2015 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/"; target="_blank">Apache License, Version 2.0</a>. <br /><small> http://git-wip-us.apache.org/repos/asf/polygene-website/blob/538baaf6/content/java/develop/sample-forum.html ---------------------------------------------------------------------- diff --git a/content/java/develop/sample-forum.html b/content/java/develop/sample-forum.html index 20b1302..3e9affb 100644 --- a/content/java/develop/sample-forum.html +++ b/content/java/develop/sample-forum.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Forum Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="sample-dci.html" title="DCI Sample" /><link rel="next" href="sample-car-rental.html" title="Car Rental Sample" /> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html xmlns="http://www.w3.org/1999/xhtml";><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Forum Sample</title><link rel="stylesheet" type="text/css" href="css/style.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="" /><link rel="up" href="samples.html" title="Samples" /><link rel="prev" href="sample-dci.html" title="DCI Sample" /><link rel="next" href="sample-car-rental.html" title="Car Rental Sample" /> <!-- favicon --> @@ -66,7 +66,7 @@ })(); </script> - </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</a></span></dt><dt><span class="section"><a href="glossary.ht ml">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-forum.html">Forum Sample</span></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section" title="Forum Sample"><div class="titlepage"><div><div><h3 class="title"><a id="sample-forum"></a>Forum Sample</h3></div></div></div><p>Sample of how to build a web forum using <a class="xref" href="library-rest-server.html" title="ReST Server"> ReST Server Library</a>, + </head><body><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="logo"><a href="index.html"><img src="images/logo-standard.png" style="width:80%;height:80%; padding-top:20px;" /></a></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="top-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="index.html#home">Polygeneâ¢</a></span></dt><dt><span class="section"><a href="intro.html">Introduction</a></span></dt><dt><span class="section"><a href="tutorials.html">Tutorials</a></span></dt><dt><span class="section"><a href="javadocs.html">Javadoc</a></span></dt><dt><span class="section"><span xmlns="" href="samples.html">Samples</span></span></dt><dt><span class="section"><a href="core.html">Core</a></span></dt><dt><span class="section"><a href="libraries.html">Libraries</a></span></dt><dt><span class="section"><a href="extensions.html">Extensions</a></span></dt><dt><span class="section"><a href="tools.html">Tools</ a></span></dt><dt><span class="section"><a href="glossary.html">Glossary </a></span></dt></dl></div></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="sub-nav"><div xmlns="http://www.w3.org/1999/xhtml"; class="toc"><dl class="toc"><dt><span class="section"><a href="samples.html#_overview_2">Overview</a></span></dt><dt><span class="section"><a href="sample-dci.html">DCI Sample</a></span></dt><dt><span class="section"><span xmlns="" href="sample-forum.html">Forum Sample</span></span></dt><dt><span class="section"><a href="sample-car-rental.html">Car Rental Sample</a></span></dt><dt><span class="section"><a href="sample-sql-support.html">SQL Support Sample</a></span></dt><dt><span class="section"><a href="sample-swing.html">Swing Bindings Sample</a></span></dt></dl></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="sample-forum"></a>Forum Sample</h3></div></div></div><p>Sample of how to build a web forum using <a class="xref" href="l ibrary-rest-server.html" title="ReST Server"> ReST Server Library</a>, <a class="xref" href="extension-es-file.html" title="File EntityStore">File EntityStore</a> and <a class="xref" href="library-fileconfig.html" title="FileConfig">FileConfig Library</a>.</p><p><a class="ulink" href="https://github.com/apache/polygene-java/tree/develop/samples/forum"; target="_top">Browse Source</a></p></div><div xmlns="" xmlns:exsl="http://exslt.org/common"; class="footer"><p> Copyright © 2015 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/"; target="_blank">Apache License, Version 2.0</a>. <br /><small>
