Repository: incubator-apex-site Updated Branches: refs/heads/asf-site f4d9009b1 -> 139b52fb1
from a98581e4e2cdb30c8647a22ee4f168d1d0eb81f6 Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/commit/f61e75e6 Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/tree/f61e75e6 Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/diff/f61e75e6 Branch: refs/heads/asf-site Commit: f61e75e67713808eef91c60915ba09c688f1b7b3 Parents: 1e26fbc Author: sashadt <[email protected]> Authored: Tue Nov 24 13:33:15 2015 -0800 Committer: sashadt <[email protected]> Committed: Tue Nov 24 13:33:15 2015 -0800 ---------------------------------------------------------------------- content/announcements.html | 129 +++++++++++++++++++++++ content/community.html | 100 +++++++++++------- content/contributing.html | 132 ++++++++++++++++------- content/css/main.css | 199 ++++++++++++++++++++++++++++++++++- content/docs.html | 51 ++++++--- content/downloads.html | 202 +++++++++++++++++++++++++++++++++++ content/index.html | 31 +++++- content/release.html | 226 ++++++++++++++++++++++++++++++++++++++++ 8 files changed, 969 insertions(+), 101 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/announcements.html ---------------------------------------------------------------------- diff --git a/content/announcements.html b/content/announcements.html new file mode 100644 index 0000000..40ff7d4 --- /dev/null +++ b/content/announcements.html @@ -0,0 +1,129 @@ +<html lang="en"><head> + + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> + <meta name="description" content="Apex is an enterprise grade native YARN big data-in-motion platform that unifies stream processing as well as batch processing."> + <meta name="author" content="Apache Software Foundation"> + <link rel="icon" href="favicon.ico"> + + <title>Apache Apex (Incubating)</title> + + <!-- Main Stylesheet --> + <link href="css/main.css" rel="stylesheet"> + + </head> + + <body> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> + <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> + Apache Apex + <small>(incubating)</small> + </a> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/announcements.html">Announcements</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/community.html">Community</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/docs.html">Docs</a> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-core.git";>Apex Core (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-core";>Apex Core (Github Mirror)</a></li> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-malhar.git";>Apex Malhar (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-malhar";>Apex Malhar (Github Mirror)</a></li> + </ul> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Apache<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="http://incubator.apache.org/projects/apex.html";>Status Page</a></li> + <li><a href="http://www.apache.org/foundation/how-it-works.html";>Apache Foundation</a></li> + <li><a href="http://www.apache.org/licenses/";>Apache License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> + </ul> + </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> + </ul> + + </div> + </nav> +<div class="container"> + <div class="col-md-8"> + + <h1 id="announcements">Announcements</h1> +<h2 id="malhar-library-release-3-2-0-incubating">Malhar Library release 3.2.0-incubating</h2> +<p>Nov 16, 2015. The Apache Apex community is pleased to announce release 3.2.0-incubating of the Malhar Library.</p> +<p>Changes: <a href="https://github.com/apache/incubator-apex-malhar/blob/v3.2.0-incubating/CHANGELOG.md";>https://github.com/apache/incubator-apex-malhar/blob/v3.2.0-incubating/CHANGELOG.md</a></p> +<p>Source Release: <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz";>http://www.apache.org/dyn/closer.lua/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz</a></p> +<p>or visit:</p> +<p><a href="http://apex.incubator.apache.org/downloads.html";>http://apex.incubator.apache.org/downloads.html</a></p> +<p>We welcome your help and feedback.</p> +<h2 id="apex-core-release-3-2-0-incubating">Apex Core release 3.2.0-incubating</h2> +<p>Oct 30, 2015. The Apache Apex community is pleased to announce release 3.2.0-incubating of the Core.</p> +<p>Changes: <a href="https://github.com/apache/incubator-apex-core/blob/v3.2.0-incubating/CHANGELOG.md";>https://github.com/apache/incubator-apex-core/blob/v3.2.0-incubating/CHANGELOG.md</a></p> +<p>Source Release: <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/core/v3.2.0-incubating/core-3.2.0-incubating-source-release.tar.gz";>http://www.apache.org/dyn/closer.lua/incubator/apex/core/v3.2.0-incubating/core-3.2.0-incubating-source-release.tar.gz</a></p> +<p>or visit:</p> +<p><a href="http://apex.incubator.apache.org/downloads.html";>http://apex.incubator.apache.org/downloads.html</a></p> +<p>We welcome your help and feedback.</p> + + </div> + <div class="col-md-4"> + + <h2 id="upcoming-meetups">Upcoming Meetups</h2> +<p><a href="http://www.meetup.com/Apache-Apex-incubating-Meetup-Pune/events/226506211/";>Pune - Nov 25, 2015</a> - Real Time Insights for Advertising Tech using Apex </p> +<p><a href="http://www.meetup.com/Apex-Bay-Area-Chapter/events/226817171/";>Palo Alto â Dec 2, 2015</a> - Apache Apex at Big Data Application Meetup at Cask </p> + + </div> +</div> + + <hr> + <div class="container"> + <footer id="main-footer"> + <p> + Copyright © <span id="copyright-year">2015</span> <a href="http://apache.org";>The Apache Software Foundation</a>, + Licensed under the Apache License, Version 2.0<br> + Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br> + <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> + <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> + </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> + </footer> + </div> <!-- /container --> + + <!-- Placed at the end of the document so the pages load faster --> + <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js";></script> + <script src="/js/bootstrap.min.js"></script> + <script> + $('#copyright-year').text((new Date()).getFullYear()); + </script> + +</body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/community.html ---------------------------------------------------------------------- diff --git a/content/community.html b/content/community.html index 5709200..1108813 100644 --- a/content/community.html +++ b/content/community.html @@ -16,22 +16,36 @@ </head> <body> - <nav class="navbar navbar-static-top" id="main-nav"> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> <a class="navbar-brand" href="/"> <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> Apache Apex <small>(incubating)</small> </a> - <ul class="nav nav-pills navbar-right"> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> <li class="nav-item"> - <a class="nav-link" href="/">Home</a> + <a class="nav-link " href="/announcements.html">Announcements</a> </li> <li class="nav-item"> - <a class="nav-link" href="/community.html">Community</a> + <a class="nav-link " href="/community.html">Community</a> </li> <li class="nav-item"> - <a class="nav-link" href="/docs.html">Docs</a> + <a class="nav-link " href="/docs.html">Docs</a> </li> <li class="nav-item"> <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> @@ -52,45 +66,52 @@ <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> </ul> </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> </ul> + </div> </nav> <div class="container"> <h1 id="community">Community</h1> - <h2 id="mailing-lists">Mailing Lists</h2> - <p>The following mailing lists can be used to get help with Apex.</p> - <ul> - <li><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/";>[email protected]</a> is for people who want to contribute code to apex. <a href="mailto:[email protected]?subject=send%20this%20email%20to%20subscribe";>subscribe</a>, <a href="mailto:[email protected]?subject=send%20this%20email%20to%20unsubscribe";>unsubscribe</a>, <a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/";>archives</a></li> - <li><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-commits/";>[email protected]</a> is for commit messages and patches to apex. <a href="mailto:[email protected]?subject=send%20this%20email%20to%20subscribe";>subscribe</a>, <a href="mailto:[email protected]?subject=send%20this%20email%20to%20unsubscribe";>unsubscribe</a>, <a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-commits/";>archives</a></li> - </ul> - <h2 id="github-repositories">Github Repositories</h2> - <p>The Apex Project is made up of two repositories:</p> - <ul> - <li><a href="https://github.com/apache/incubator-apex-core";>Apex Core</a> - The core of the Apex platform.</li> - <li><a href="https://github.com/apache/incubator-apex-malhar";>Apex Malhar</a> - Community-driven set of open-source "operators" and utilities for use in your Apex applications.</li> - </ul> - <p><strong>To learn more about how we use Github to accept contributions to the project, <a href="/contributing.html">check out the contributing guidelines</a>.</strong></p> - <h2 id="issue-tracking">Issue Tracking</h2> - <ul> - <li><a href="https://malhar.atlassian.net/projects/APEX/issues";>Apex Core JIRA</a></li> - <li><a href="https://malhar.atlassian.net/projects/MLHR/issues";>Apex Malhar JIRA</a></li> - </ul> - <h2 id="upcoming-meetups">Upcoming Meetups</h2> - <ul> - <li>PubMatic to Share Real Time Insights for Advertising Tech using Apex @ MapR Office <a href="http://www.meetup.com/Apex-Bay-Area-Chapter/events/226184395/";>San Jose - Nov 19, 2015</a></li> - <li>Apache Apex â Deep Dive <a href="http://www.meetup.com/Apache-Apex-incubating-Meetup-Pune/events/226506211/";>Pune - Nov 25, 2015</a></li> - </ul> - <h2 id="meetup-groups">Meetup Groups</h2> - <ul> - <li><a href="http://www.meetup.com/Apache-Apex-Meetup-Chicago-Chapter";>Chicago Chapter</a></li> - <li><a href="http://www.meetup.com/Apex-Meetup-Houston";>Houston Chapter</a></li> - <li><a href="http://www.meetup.com/Apex-Meetup-Columbus";>Columbus Chapter</a></li> - <li><a href="http://www.meetup.com/Apache-Apex-New-York-Chapter";>New York Chapter</a></li> - <li><a href="http://www.meetup.com/Apache-Apex-incubating-Meetup-Pune";>Pune Chapter</a></li> - <li><a href="http://www.meetup.com/Apache-Apex-incubating-Bangalore-Meetup";>Bengaluru Chapter</a></li> - <li><a href="http://www.meetup.com/Apex-Bay-Area-Chapter";>Bay Area Chapter</a></li> - </ul> +<h2 id="mailing-lists">Mailing Lists</h2> +<p>The following mailing lists can be used to get help with Apex.</p> +<ul> +<li><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/";>[email protected]</a> is for people who want to contribute code to apex. <a href="mailto:[email protected]?subject=send%20this%20email%20to%20subscribe";>subscribe</a>, <a href="mailto:[email protected]?subject=send%20this%20email%20to%20unsubscribe";>unsubscribe</a>, <a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/";>archives</a></li> +<li><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-commits/";>[email protected]</a> is for commit messages and patches to apex. <a href="mailto:[email protected]?subject=send%20this%20email%20to%20subscribe";>subscribe</a>, <a href="mailto:[email protected]?subject=send%20this%20email%20to%20unsubscribe";>unsubscribe</a>, <a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-commits/";>archives</a></li> +</ul> +<h2 id="contributing">Contributing</h2> +<p><strong>To learn more about how we use Github to accept contributions to the project, <a href="/contributing.html">check out the contributing guidelines</a>.</strong></p> +<p>The Apex Project is made up of two repositories:</p> +<ul> +<li><a href="https://github.com/apache/incubator-apex-core";>Apex Core</a> - The core of the Apex platform.</li> +<li><a href="https://github.com/apache/incubator-apex-malhar";>Apex Malhar</a> - Community-driven set of open-source "operators" and utilities for use in your Apex applications.</li> +</ul> +<h2 id="release-process">Release Process</h2> +<p><strong>To learn more about the release process for Apex, <a href="/release.html">check out the release guidelines</a>.</strong></p> +<h2 id="issue-tracking">Issue Tracking</h2> +<ul> +<li><a href="https://malhar.atlassian.net/projects/APEX/issues";>Apex Core JIRA</a></li> +<li><a href="https://malhar.atlassian.net/projects/MLHR/issues";>Apex Malhar JIRA</a></li> +</ul> +<h2 id="meetup-groups">Meetup Groups</h2> +<p>To see upcoming meetup events, please visit <a href="/announcements.html">announcements page</a>.</p> +<ul> +<li><a href="http://www.meetup.com/Apache-Apex-Austin-Chapter/";>Austin Chapter</a></li> +<li><a href="http://www.meetup.com/Apex-Bay-Area-Chapter";>Bay Area Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-incubating-Bangalore-Meetup";>Bengaluru Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-Meetup-Chicago-Chapter";>Chicago Chapter</a></li> +<li><a href="http://www.meetup.com/Apex-Meetup-Columbus";>Columbus Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-Dallas-Chapter/";>Dallas Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-Denver-Chapter/";>Denver Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-El-Segundo-Chapter/";>El Segundo Chapter</a></li> +<li><a href="http://www.meetup.com/Apex-Meetup-Houston";>Houston Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-New-York-Chapter";>New York Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-Phoenix-Chapter/";>Phoenix Chapter</a></li> +<li><a href="http://www.meetup.com/Apache-Apex-incubating-Meetup-Pune";>Pune Chapter</a></li> +</ul> </div> @@ -104,6 +125,9 @@ <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> </footer> </div> <!-- /container --> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/contributing.html ---------------------------------------------------------------------- diff --git a/content/contributing.html b/content/contributing.html index 20d914a..97fd0ea 100644 --- a/content/contributing.html +++ b/content/contributing.html @@ -16,22 +16,36 @@ </head> <body> - <nav class="navbar navbar-static-top" id="main-nav"> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> <a class="navbar-brand" href="/"> <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> Apache Apex <small>(incubating)</small> </a> - <ul class="nav nav-pills navbar-right"> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> <li class="nav-item"> - <a class="nav-link" href="/">Home</a> + <a class="nav-link " href="/announcements.html">Announcements</a> </li> <li class="nav-item"> - <a class="nav-link" href="/community.html">Community</a> + <a class="nav-link " href="/community.html">Community</a> </li> <li class="nav-item"> - <a class="nav-link" href="/docs.html">Docs</a> + <a class="nav-link " href="/docs.html">Docs</a> </li> <li class="nav-item"> <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> @@ -52,46 +66,83 @@ <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> </ul> </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> </ul> + </div> </nav> <div class="container"> <h1 id="contributing-guidelines">Contributing Guidelines</h1> - <p>The apex core and apex malhar repositories both have mirror repositories on github which are used to review Pull Requests and provide a second remote endpoint for the codebase.</p> - <h2 id="opening-a-pull-request-contributors-">Opening a Pull Request (contributors)</h2> - <p>This project welcomes new contributors. If you would like to help by adding new features, enhancements or fixing bugs, here is how to do it.</p> - <ol> - <li>Create a <a href="https://malhar.atlassian.net/";>JIRA</a> for the work you plan to do (or assign yourself to an existing JIRA ticket)</li> - <li>Fork the ASF github mirror (one time step): - <a href="https://github.com/apache/incubator-apex-core/";>https://github.com/apache/incubator-apex-core/</a></li> - <li>Create a new branch from the <a href="https://github.com/apache/incubator-apex-core/tree/devel-3";>devel-3</a> branch. <strong>Name your branch with the JIRA number in it, e.g. <code>APEX-123.my-feature</code>.</strong></li> - <li>When adding new files, please include the Apache v2.0 license header.<ul> - <li>From the top level directory, run <code>mvn license:check -Dlicense.skip=false</code> to check correct header formatting.</li> - <li>Run <code>mvn license:format -Dlicense.skip=false</code> to automatically add the header when missing.</li> - </ul> - </li> - <li>Once your feature is complete, submit the pull request on github against <code>devel-3</code>.</li> - <li>If you want specific people to review your pull request, use the <code>@</code> notation in Github comments to mention that user, and request that he/she reviews your changes.</li> - <li>After all review is complete, combine all new commits into one squashed commit, and include the Jira number in the commit message. There are several ways to squash commits, but <a href="https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Squashing-Commits";>here is one explanation from git-scm.com</a>.</li> - </ol> - <p>Thanks for contributing!</p> - <h2 id="merging-a-pull-request-committers-">Merging a Pull Request (committers)</h2> - <ol> - <li>Ensure that the basic requirements for a pull request are met. This includes:<ul> - <li>Commit messages need to reference JIRA (pull requests will be linked to ticket)</li> - <li>Travis CI pull request build needs to pass</li> - <li>Ensure tests are added/modified for new features or fixes</li> - <li>Ensure appropriate JavaDoc comments have been added</li> - </ul> - </li> - <li>To set up access to the ASF source repository, <a href="https://git-wip-us.apache.org/#committers-getting-started";>follow these steps</a>. The ASF master repository is: <code>https://git-wip-us.apache.org/repos/asf/incubator-apex-core.git</code></li> - <li>Use the git command line to pull in the changes from the pull requests. You can refer to the corresponding email that will be automatically sent to the <code>[email protected]</code> mailing list to see the exact commands to merge the given pull request.</li> - <li>Once done with verification, push the changes to the ASF repository's <code>devel-3</code> branch. Within a few - seconds, the changes will propagate back to the github mirror and the pull requests be closed and marked merged automatically.</li> - <li>The <code>Fix version</code> field on the corresponding JIRA ticket needs to be set after pushing the changes.</li> - </ol> - <p><strong>Note: since none of us has write access to the mirror, only the author of a pull request can close it if it was not merged.</strong></p> +<p>The apex core and apex malhar repositories both have mirror repositories on github which are used to review Pull Requests and provide a second remote endpoint for the codebase.</p> +<h2 id="opening-a-pull-request-contributors-">Opening a Pull Request (contributors)</h2> +<p>This project welcomes new contributors. If you would like to help by adding new features, enhancements or fixing bugs, here is how to do it.</p> +<ol> +<li>Create a <a href="https://malhar.atlassian.net/";>JIRA</a> for the work you plan to do (or assign yourself to an existing JIRA ticket)</li> +<li>Fork the ASF github mirror (one time step):<br><a href="https://github.com/apache/incubator-apex-core/";>https://github.com/apache/incubator-apex-core/</a> </li> +<li>Clone the <strong>fork</strong> on your local workspace (one time step):<br><code>git clone https://github.com/{github_username}/incubator-apex-core.git</code></li> +<li>Add <a href="https://github.com/apache/incubator-apex-core";>incubator apex core</a> as a remote repository (one time step):<br><code>git remote add upstream https://github.com/apache/incubator-apex-core</code></li> +<li>Create a new branch from the <a href="https://github.com/apache/incubator-apex-core/tree/devel-3";>devel-3</a> branch. <strong>Name your branch with the JIRA number in it, e.g. <code>APEX-123.my-feature</code>.</strong><br><code>git checkout -b APEX-123.my-feature -t upstream/devel-3</code><br>Creating a local branch that tracks a remote makes pull easier (no need to specify the remote branch while pulling). A branch can be made to track a remote branch anytime, not necessarily at its creation by:<br><code>git branch -u upstream/devel-3</code></li> +<li>When adding new files, please include the Apache v2.0 license header.<ul> +<li>From the top level directory, run <code>mvn license:check -Dlicense.skip=false</code> to check correct header formatting.</li> +<li>Run <code>mvn license:format -Dlicense.skip=false</code> to automatically add the header when missing.</li> +</ul> +</li> +<li>Once your feature is complete, submit the pull request on github against <code>devel-3</code>.</li> +<li>If you want specific people to review your pull request, use the <code>@</code> notation in Github comments to mention that user, and request that he/she reviews your changes.</li> +<li><p>After all review is complete, combine all new commits into one squashed commit except when there are multiple contributors, and include the Jira number in the commit message. There are several ways to squash commits, but <a href="https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Squashing-Commits";>here is one explanation from git-scm.com</a> and a simple example is illustrated below:</p> +<p>If tracking upstream/devel-3 then run <code>git rebase -i</code>. Else run <code>git rebase -i upstream/devel-3</code>.<br>This command opens the text editor which lists the multiple commits:</p> +<pre><code>pick 67cd79b change1 +pick 6f98905 change2 + +# Rebase e13748b..3463fbf onto e13748b (2 command(s)) +# +# Commands: +# p, pick = use commit +# r, reword = use commit, but edit the commit message +# e, edit = use commit, but stop for amending +# s, squash = use commit, but meld into previous commit +# f, fixup = like "squash", but discard this commit's log message +# x, exec = run command (the rest of the line) using shell +# +# These lines can be re-ordered; they are executed from top to bottom. +</code></pre><p>Squash 'change2' to 'change1' and save.</p> +<pre><code>pick 67cd79b change1 +squash 6f98905 change2 +</code></pre></li> +<li>If there are multiple contributors in a pull request preserve individual attributions. Try to squash the commits to the minimum number of commits required to preserve attribution and the contribution to still be functionally correct.</li> +<li>Till the review is complete it may happen that working feature branch may diverge from <code>devel-3</code> substantially. Therefore, it is recommended to frequently merge <code>devel-3</code> to the branch being worked on by:<ul> +<li>when the branch tracks upstream/devel-3<br><code>git pull</code></li> +<li>when the branch doesn't track upstream<br><code>git pull upstream devel-3</code></li> +</ul> +</li> +<li>If a pull from <code>devel-3</code> results in a conflict then resolve it and commit the merge. This results in additional merge commits in the pull request. Following steps help to ensure that the final pull request contains just one commit:<ul> +<li>Rename the original branch:<br><code>git branch -m APEX-123.my-feature.squash</code></li> +<li>Create a new branch (with the original name) from upstream/devel-3 that has latest changes:<br><code>git checkout -b APEX-123.my-feature -t upstream/devel-3</code></li> +<li>Squash merge the old branch which was renamed. When the new branch has the latest changes then this squash will result only in the changes that were made for the feature:<br><code>git merge --squash APEX-123.my-feature.squash</code></li> +<li>Commit the squash and force push it to the old feature remote branch so that the pull request is automatically updated:<br><code>git commit -m "APEX-123 #comment added my-feature"</code><br><code>git push origin +APEX-123.my-feature</code></li> +<li>Delete the extra squash branch:<br><code>git branch -D APEX-123.my-feature.squash</code></li> +</ul> +</li> +</ol> +<p>Thanks for contributing!</p> +<h2 id="merging-a-pull-request-committers-">Merging a Pull Request (committers)</h2> +<ol> +<li>Ensure that the basic requirements for a pull request are met. This includes:<ul> +<li>Commit messages need to reference JIRA (pull requests will be linked to ticket)</li> +<li>Travis CI pull request build needs to pass</li> +<li>Ensure tests are added/modified for new features or fixes</li> +<li>Ensure appropriate JavaDoc comments have been added</li> +</ul> +</li> +<li>To set up access to the ASF source repository, <a href="https://git-wip-us.apache.org/#committers-getting-started";>follow these steps</a>. The ASF master repository is: <code>https://git-wip-us.apache.org/repos/asf/incubator-apex-core.git</code></li> +<li>Use the git command line to pull in the changes from the pull requests. You can refer to the corresponding email that will be automatically sent to the <code>[email protected]</code> mailing list to see the exact commands to merge the given pull request.</li> +<li>Once done with verification, push the changes to the ASF repository's <code>devel-3</code> branch. Within a few<br>seconds, the changes will propagate back to the github mirror and the pull requests be closed and marked merged automatically.</li> +<li>The <code>Fix version</code> field on the corresponding JIRA ticket needs to be set after pushing the changes.</li> +</ol> +<p><strong>Note: since none of us has write access to the mirror, only the author of a pull request can close it if it was not merged.</strong></p> </div> @@ -105,6 +156,9 @@ <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> </footer> </div> <!-- /container --> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/css/main.css ---------------------------------------------------------------------- diff --git a/content/css/main.css b/content/css/main.css index cde77d6..2d75b77 100644 --- a/content/css/main.css +++ b/content/css/main.css @@ -6766,7 +6766,8 @@ button.close { } #main-nav { background-color: #1ea3dd; - margin-bottom: 10px; + margin-bottom: 0; + border: none; } #main-nav .nav-link { color: white; @@ -6775,6 +6776,16 @@ button.close { #main-nav .nav-link:hover { background: #8bd1ef; } +#main-nav .nav-link.btn { + padding-bottom: 7px; + padding-top: 7px; + margin-top: 8px; + margin-left: 5px; + margin-right: 5px; +} +#main-nav .nav-link.btn.btn-success:hover { + background-color: #449d44; +} #main-nav .navbar-brand { font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif; color: white; @@ -6790,14 +6801,22 @@ button.close { float: left; margin-right: 5px; } -#main-nav ul { - margin-top: 6px; -} #main-nav .nav .open > a, #main-nav .nav .open > a:hover, #main-nav .nav .open > a:focus { color: #555555; } +@media (max-width: 767px) { + .navbar-default .navbar-nav .open .dropdown-menu > li > a { + color: #EFEFEF; + } + .navbar-nav .open .dropdown-menu { + background-color: #48b6e6; + } +} +.navbar-toggle { + background-color: rgba(255, 255, 255, 0.5); +} #main-footer { text-align: center; color: #777777; @@ -6837,3 +6856,175 @@ button.close { body { -webkit-font-smoothing: antialiased; } +.latest-tag { + display: none; +} +.table tbody tr:first-child .latest-tag { + display: inline; +} +/* + +Colorbrewer theme +Original: https://github.com/mbostock/colorbrewer-theme (c) Mike Bostock <[email protected]> +Ported by FabrÃcio Tavares de Oliveira + +*/ + +.hljs { + display: block; + overflow-x: auto; + padding: 0.5em; + background: #fff; + -webkit-text-size-adjust: none; +} + +.hljs, +.hljs-subst, +.hljs-tag .hljs-title, +.nginx .hljs-title { + color: #000; +} + +.hljs-string, +.hljs-title, +.hljs-constant, +.hljs-parent, +.hljs-tag .hljs-value, +.hljs-rule .hljs-value, +.hljs-preprocessor, +.hljs-pragma, +.haml .hljs-symbol, +.ruby .hljs-symbol, +.ruby .hljs-symbol .hljs-string, +.hljs-template_tag, +.django .hljs-variable, +.smalltalk .hljs-class, +.hljs-addition, +.hljs-flow, +.hljs-stream, +.bash .hljs-variable, +.apache .hljs-tag, +.apache .hljs-cbracket, +.tex .hljs-command, +.tex .hljs-special, +.erlang_repl .hljs-function_or_atom, +.asciidoc .hljs-header, +.markdown .hljs-header, +.coffeescript .hljs-attribute, +.hljs-name { + color: #756bb1; +} + +.smartquote, +.hljs-comment, +.hljs-annotation, +.diff .hljs-header, +.hljs-chunk, +.asciidoc .hljs-blockquote, +.markdown .hljs-blockquote { + color: #636363; +} + +.hljs-number, +.hljs-date, +.hljs-regexp, +.hljs-literal, +.hljs-hexcolor, +.smalltalk .hljs-symbol, +.smalltalk .hljs-char, +.go .hljs-constant, +.hljs-change, +.lasso .hljs-variable, +.makefile .hljs-variable, +.asciidoc .hljs-bullet, +.markdown .hljs-bullet, +.asciidoc .hljs-link_url, +.markdown .hljs-link_url { + color: #31a354; +} + +.hljs-label, +.ruby .hljs-string, +.hljs-decorator, +.hljs-filter .hljs-argument, +.hljs-localvars, +.hljs-array, +.hljs-attr_selector, +.hljs-important, +.hljs-pseudo, +.hljs-pi, +.haml .hljs-bullet, +.hljs-doctype, +.hljs-deletion, +.hljs-envvar, +.hljs-shebang, +.apache .hljs-sqbracket, +.nginx .hljs-built_in, +.hljs-list .hljs-built_in, +.tex .hljs-formula, +.erlang_repl .hljs-reserved, +.hljs-prompt, +.asciidoc .hljs-link_label, +.markdown .hljs-link_label, +.vhdl .hljs-attribute, +.clojure .hljs-attribute, +.asciidoc .hljs-attribute, +.lasso .hljs-attribute, +.coffeescript .hljs-property, +.hljs-phony { + color: #88f; +} + + + +.hljs-keyword, +.hljs-id, +.hljs-title, +.hljs-built_in, +.css .hljs-tag, +.hljs-doctag, +.smalltalk .hljs-class, +.hljs-winutils, +.bash .hljs-variable, +.apache .hljs-tag, +.hljs-type, +.hljs-typename, +.tex .hljs-command, +.asciidoc .hljs-strong, +.markdown .hljs-strong, +.hljs-request, +.hljs-status { + color: #3182bd; +} + +.asciidoc .hljs-emphasis, +.markdown .hljs-emphasis { + font-style: italic; +} + +.nginx .hljs-built_in { + font-weight: normal; +} + +.coffeescript .javascript, +.javascript .xml, +.lasso .markup, +.tex .hljs-formula, +.xml .javascript, +.xml .vbscript, +.xml .css, +.xml .hljs-cdata { + opacity: 0.5; +} + +.css .hljs-attribute, +.html .hljs-attribute { + color: #e6550d; +} + +.css .hljs-class, +.html .hljs-tag, +.html .hljs-title { + color: #3182bd; +} + http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/docs.html ---------------------------------------------------------------------- diff --git a/content/docs.html b/content/docs.html index 1d3e75d..8b6b9fa 100644 --- a/content/docs.html +++ b/content/docs.html @@ -16,22 +16,36 @@ </head> <body> - <nav class="navbar navbar-static-top" id="main-nav"> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> <a class="navbar-brand" href="/"> <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> Apache Apex <small>(incubating)</small> </a> - <ul class="nav nav-pills navbar-right"> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> <li class="nav-item"> - <a class="nav-link" href="/">Home</a> + <a class="nav-link " href="/announcements.html">Announcements</a> </li> <li class="nav-item"> - <a class="nav-link" href="/community.html">Community</a> + <a class="nav-link " href="/community.html">Community</a> </li> <li class="nav-item"> - <a class="nav-link" href="/docs.html">Docs</a> + <a class="nav-link " href="/docs.html">Docs</a> </li> <li class="nav-item"> <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> @@ -52,22 +66,26 @@ <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> </ul> </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> </ul> + </div> </nav> <div class="container"> <h1 id="documentation">Documentation</h1> - <p>New documentation will be coming soon!</p> - <p>Here are a few resources to get started with Apex:</p> - <ul> - <li><a href="https://www.datatorrent.com/docs/guides/ApplicationDeveloperGuide.html";>Application Developer Guide</a></li> - <li><a href="https://www.datatorrent.com/docs/guides/ApplicationPackages.html";>Application Packages Guide</a></li> - <li><a href="https://www.datatorrent.com/docs/guides/OperatorDeveloperGuide.html";>Operator Developer Guide</a></li> - <li><a href="/github-mirror-pull-requests.html">Merging Github Mirror Pull Requests</a></li> - <li><a href="https://www.datatorrent.com/docs/apidocs/";>JavaDoc</a></li> - <li><a href="https://www.datatorrent.com/blog-apex-performance-benchmark/";>Benchmarks compare between 2.0 and 3.0</a></li> - </ul> +<p>New documentation will be coming soon!</p> +<p>Here are a few resources to get started with Apex:</p> +<ul> +<li><a href="http://docs.datatorrent.com/application_development/";>Application Developer Guide</a></li> +<li><a href="http://docs.datatorrent.com/application_packages/";>Application Packages Guide</a></li> +<li><a href="http://docs.datatorrent.com/operator_development/";>Operator Developer Guide</a></li> +<li><a href="/github-mirror-pull-requests.html">Merging Github Mirror Pull Requests</a></li> +<li><a href="https://www.datatorrent.com/docs/apidocs/";>JavaDoc</a></li> +<li><a href="https://www.datatorrent.com/blog-apex-performance-benchmark/";>Benchmarks compare between 2.0 and 3.0</a></li> +</ul> </div> @@ -81,6 +99,9 @@ <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> </footer> </div> <!-- /container --> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/downloads.html ---------------------------------------------------------------------- diff --git a/content/downloads.html b/content/downloads.html new file mode 100644 index 0000000..7118825 --- /dev/null +++ b/content/downloads.html @@ -0,0 +1,202 @@ +<html lang="en"><head> + + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> + <meta name="description" content="Apex is an enterprise grade native YARN big data-in-motion platform that unifies stream processing as well as batch processing."> + <meta name="author" content="Apache Software Foundation"> + <link rel="icon" href="favicon.ico"> + + <title>Apache Apex (Incubating)</title> + + <!-- Main Stylesheet --> + <link href="css/main.css" rel="stylesheet"> + + </head> + + <body> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> + <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> + Apache Apex + <small>(incubating)</small> + </a> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/announcements.html">Announcements</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/community.html">Community</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/docs.html">Docs</a> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-core.git";>Apex Core (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-core";>Apex Core (Github Mirror)</a></li> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-malhar.git";>Apex Malhar (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-malhar";>Apex Malhar (Github Mirror)</a></li> + </ul> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Apache<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="http://incubator.apache.org/projects/apex.html";>Status Page</a></li> + <li><a href="http://www.apache.org/foundation/how-it-works.html";>Apache Foundation</a></li> + <li><a href="http://www.apache.org/licenses/";>Apache License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> + </ul> + </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> + </ul> + + </div> + </nav> +<div class="container"> + + <h1>Downloads</h1> + + <!-- APEX CORE SOURCE RELEASES TABLE --> + <h2>Apex Source Releases</h2> + <table class="table table-bordered table-striped"> + <thead> + <tr> + <th scope="col">Version</th> + <th scope="col">Date</th> + <th scope="col">Source (zip)</th> + <th scope="col">Source (tarball)</th> + </tr> + </thead> + <tbody> + <tr> + <td> + 3.2.0-incubating + <span class="latest-tag">(latest)</span> + </td> + <td> + 2015-10-30 + </td> + <td> + <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.zip";>apex-3.2.0-incubating-source-release.zip</a><br> + <small> + ( + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.zip.asc";>pgp</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.zip.md5";>md5</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.zip.sha";>sha1</a> + ) + </small> + </td> + <td> + <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.tar.gz";>apex-3.2.0-incubating-source-release.tar.gz</a><br> + <small> + ( + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.tar.gz.asc";>pgp</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.tar.gz.md5";>md5</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating/apex-3.2.0-incubating-source-release.tar.gz.sha";>sha1</a> + ) + </small> + </td> + </tr> + </tbody> + </table> + + <!-- APEX MALHAR SOURCE RELEASES TABLE --> + <h2>Malhar Source Releases</h2> + <table class="table table-bordered table-striped"> + <thead> + <tr> + <th scope="col">Version</th> + <th scope="col">Date</th> + <th scope="col">Source (zip)</th> + <th scope="col">Source (tarball)</th> + </tr> + </thead> + <tbody> + <tr> + <td> + 3.2.0-incubating + <span class="latest-tag">(latest)</span> + </td> + <td> + 2015-11-16 + </td> + <td> + <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.zip";>malhar-3.2.0-incubating-source-release.zip</a><br> + <small> + ( + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.zip.asc";>pgp</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.zip.md5";>md5</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.zip.sha";>sha1</a> + ) + </small> + </td> + <td> + <a href="http://www.apache.org/dyn/closer.lua/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz";>malhar-3.2.0-incubating-source-release.tar.gz</a><br> + <small> + ( + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz.asc";>pgp</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz.md5";>md5</a>, + <a href="https://dist.apache.org/repos/dist/release/incubator/apex/malhar/v3.2.0-incubating/malhar-3.2.0-incubating-source-release.tar.gz.sha";>sha1</a> + ) + </small> + </td> + </tr> + </tbody> + </table> + + + <h2 id="third-party-downloads">Third-Party Downloads</h2> +<p>This is a list of 3rd party binary packages based on Apache Apex. The Apache Apex project does not endorse or maintain any 3rd party binary packages.</p> +<ul> +<li><a href="https://www.datatorrent.com/download/";>DataTorrent RTS</a> is a binary build of Apache Apex created by <a href="https://datatorrent.com";>DataTorrent</a>.</li> +</ul> +<p>If you would like to provide your own edition of Apache Apex here, please send email to <a href="mailto:[email protected]";>[email protected]</a>.</p> + +</div> + + <hr> + <div class="container"> + <footer id="main-footer"> + <p> + Copyright © <span id="copyright-year">2015</span> <a href="http://apache.org";>The Apache Software Foundation</a>, + Licensed under the Apache License, Version 2.0<br> + Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br> + <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> + <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> + </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> + </footer> + </div> <!-- /container --> + + <!-- Placed at the end of the document so the pages load faster --> + <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js";></script> + <script src="/js/bootstrap.min.js"></script> + <script> + $('#copyright-year').text((new Date()).getFullYear()); + </script> + +</body> +</html> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/index.html ---------------------------------------------------------------------- diff --git a/content/index.html b/content/index.html index 82f1712..604d10a 100644 --- a/content/index.html +++ b/content/index.html @@ -16,22 +16,36 @@ </head> <body> - <nav class="navbar navbar-static-top" id="main-nav"> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> <a class="navbar-brand" href="/"> <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> Apache Apex <small>(incubating)</small> </a> - <ul class="nav nav-pills navbar-right"> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> <li class="nav-item"> - <a class="nav-link" href="/">Home</a> + <a class="nav-link " href="/announcements.html">Announcements</a> </li> <li class="nav-item"> - <a class="nav-link" href="/community.html">Community</a> + <a class="nav-link " href="/community.html">Community</a> </li> <li class="nav-item"> - <a class="nav-link" href="/docs.html">Docs</a> + <a class="nav-link " href="/docs.html">Docs</a> </li> <li class="nav-item"> <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> @@ -52,7 +66,11 @@ <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> </ul> </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> </ul> + </div> </nav> <!-- Main jumbotron for a primary marketing message or call to action --> @@ -101,6 +119,9 @@ <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> </footer> </div> <!-- /container --> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/f61e75e6/content/release.html ---------------------------------------------------------------------- diff --git a/content/release.html b/content/release.html new file mode 100644 index 0000000..5d16152 --- /dev/null +++ b/content/release.html @@ -0,0 +1,226 @@ +<html lang="en"><head> + + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> + <meta name="description" content="Apex is an enterprise grade native YARN big data-in-motion platform that unifies stream processing as well as batch processing."> + <meta name="author" content="Apache Software Foundation"> + <link rel="icon" href="favicon.ico"> + + <title>Apache Apex (Incubating)</title> + + <!-- Main Stylesheet --> + <link href="css/main.css" rel="stylesheet"> + + </head> + + <body> + <nav class="navbar navbar-default navbar-static-top" id="main-nav"> + <div class="container"> + + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <img src="images/apex-logo.svg" class="logo" alt="Apache Apex Logo"> + Apache Apex + <small>(incubating)</small> + </a> + </div> + + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-right navbar-nav"> + <li class="nav-item"> + <a class="nav-link " href="/">Home</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/announcements.html">Announcements</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/community.html">Community</a> + </li> + <li class="nav-item"> + <a class="nav-link " href="/docs.html">Docs</a> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Source<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-core.git";>Apex Core (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-core";>Apex Core (Github Mirror)</a></li> + <li><a href="https://git-wip-us.apache.org/repos/asf?p=incubator-apex-malhar.git";>Apex Malhar (ASF)</a></li> + <li><a href="https://github.com/apache/incubator-apex-malhar";>Apex Malhar (Github Mirror)</a></li> + </ul> + </li> + <li class="nav-item"> + <a href="#" data-toggle="dropdown" class="dropdown-toggle nav-link">Apache<b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="http://incubator.apache.org/projects/apex.html";>Status Page</a></li> + <li><a href="http://www.apache.org/foundation/how-it-works.html";>Apache Foundation</a></li> + <li><a href="http://www.apache.org/licenses/";>Apache License</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> + </ul> + </li> + <li class="nav-item"> + <a class="nav-link btn btn-success" href="/downloads.html">Download</a> + </li> + </ul> + + </div> + </nav> +<div class="container"> + + <h1 id="how-to-release-apache-apex-incubating-">How to release Apache Apex (incubating)</h1> +<p>For general information on ASF releases, see:<br><a href="http://incubator.apache.org/guides/releasemanagement.html";>http://incubator.apache.org/guides/releasemanagement.html</a><br><a href="http://www.apache.org/dev/release.html";>http://www.apache.org/dev/release.html</a></p> +<h2 id="creating-release-branch">Creating Release Branch</h2> +<p>If this is a minor release (X.Y.0), start with creating a new branch. Example for 3.2.0:</p> +<pre><code class="lang-bash">git checkout devel-3 && git pull +git checkout -b release-3.2 devel-3 +</code></pre> +<p>Replace version in devel-3 branch:</p> +<pre><code>git checkout devel-3 +git grep -l "3.2.0-incubating-SNAPSHOT" +</code></pre><p>For informational purpose, this should yield the list of files that needs the version number replaced to X.(Y+1).0 next version. Note that the replacement step is different between the repositories due to an open issue. See:</p> +<p><a href="https://malhar.atlassian.net/browse/APEX-34";>https://malhar.atlassian.net/browse/APEX-34</a></p> +<p>For -core: </p> +<pre><code class="lang-bash">dv=3.2.0-incubating-SNAPSHOT +rv=3.3.0-incubating-SNAPSHOT +for a in `git grep -l "${dv}"`; do echo $a; sed -i 's/'"${dv}"'/'"${rv}"'/g' $a; done +</code></pre> +<p>For -malhar:</p> +<pre><code>mvn versions:set -DnewVersion=${rv} +</code></pre><p>Commit and push the change:</p> +<pre><code>git commit -m "Preparing for 3.3.0 development" +git push apache devel-3 +</code></pre><h2 id="preparing-release-candidate">Preparing Release Candidate</h2> +<h3 id="add-missing-since-tags">Add missing @since tags</h3> +<p>For Java classes added since the last release, the @since tags need to be added. The javadoc plugin inserts missing tags, but does not play well with the license header when no class level documentation block is present. This is tracked as</p> +<p><a href="https://malhar.atlassian.net/browse/APEX-183";>https://malhar.atlassian.net/browse/APEX-183</a></p> +<p>It also removes the custom @tags doclet tag when the existing JavaDoc is malformed, <strong>do not use this to make changes in Malhar</strong>. Until these problems are resolved, following (convoluted) procedure can be used <strong>only for -core</strong> to get the work done. </p> +<p>Find the files that need to be modified:</p> +<pre><code>yes | mvn javadoc:fix -DdefaultSince=3.2.0 -DfixTags=since -DignoreClirr=true -DfixFieldComment=false -DfixMethodComment=false +</code></pre><p>The tags were inserted in the wrong place, remove the leading blank line added in previous step and replace <code>/**</code> with <code>/*</code> for affected files:</p> +<pre><code>git status -s | awk '{print $2}' | xargs sed -i ':a;N;$!ba;s!^\n/\*\*!/*!' +</code></pre><p>Now repeat and insert tags in correct place:</p> +<pre><code>yes | mvn javadoc:fix -DdefaultSince=3.2.0 -DfixTags=since -DignoreClirr=true -DfixFieldComment=false -DfixMethodComment=false +</code></pre><p>Finally restore license headers to what they used to be:</p> +<pre><code>mvn license:format -Dlicense.skip=false +</code></pre><p>Do a git diff to double check, if all looks good commit and create pull request</p> +<h3 id="update-changelog-from-jira">Update CHANGELOG from JIRA</h3> +<p>Navigate to the unreleased version, example for 3.2.0:</p> +<p><a href="https://malhar.atlassian.net/projects/APEX/versions/11700";>https://malhar.atlassian.net/projects/APEX/versions/11700</a></p> +<p>Obtain the release notes (text mode):</p> +<p><a href="https://malhar.atlassian.net/secure/ReleaseNote.jspa?version=11700&styleName=Text&projectId=10700";>https://malhar.atlassian.net/secure/ReleaseNote.jspa?version=11700&styleName=Text&projectId=10700</a></p> +<p>Shorten any wrapping and overly long titles to fit width. Copy the report and insert new release section into <code>CHANGELOG.md</code> with the release date set to 72 hours ahead to reflect the time for the vote.</p> +<p>Create shortlink for the JIRA release notes on <a href="http://s.apache.org/";>http://s.apache.org/</a> for use in the VOTE thread.<br>Example: <a href="http://s.apache.org/SRM";>http://s.apache.org/SRM</a></p> +<p>Commit tags and change log:</p> +<pre><code>git commit -am "Add @since tags and update change log for release 3.2.0" +</code></pre><h3 id="update-version-number-for-rc">Update version number for RC</h3> +<pre><code>dv=3.2.0-incubating-SNAPSHOT +rv=3.2.0-incubating +</code></pre><p>As mentioned earlier, use the following for -core releases:</p> +<pre><code>for a in `git grep -l "${dv}"`; do echo $a; sed -i 's/'"${dv}"'/'"${rv}"'/g' $a; done +</code></pre><p>And this for -malhar releases:</p> +<pre><code>mvn versions:set -Pall-modules -DnewVersion=${rv} +</code></pre><p>Commit version change:</p> +<pre><code>git commit -am "Preparing to release ${rv}-RC1" +git tag -a "v${rv}-RC1" -m "Release ${rv}-RC1" +</code></pre><p>Push to fork (as temporary branch), open pull request, wait for Travis CI build to succeed. Then push the tag.</p> +<pre><code>git push apache "v${rv}-RC1" +</code></pre><p>The only difference between release branch and tag is this final version number change. The branch stays at <code>-SNAPSHOT</code> version.</p> +<h2 id="build-and-deploy-release-candidate">Build and Deploy Release Candidate</h2> +<p>Prerequisites:</p> +<ul> +<li>GPG key needs to be in <a href="https://dist.apache.org/repos/dist/release/incubator/apex/KEYS";>https://dist.apache.org/repos/dist/release/incubator/apex/KEYS</a></li> +<li>Credentials for distribution management in <code>~/.m2/settings.xml</code></li> +<li>Tag pushed to ASF git</li> +</ul> +<p>Build and deploy release candidate from RC tag:</p> +<pre><code>git checkout "v${rv}-RC1" +git clean -d -f +mvn clean deploy -Papache-release -DskipTests -Dsonatype_user=<user> +</code></pre><p>Log on to <a href="https://repository.apache.org";>https://repository.apache.org</a> and look for Staging Repositories. "Close" the newly created orgapacheapex-xxxx staging repository to obtain the temporary URL, note it down for the VOTE thread.</p> +<p>Example URL: <a href="https://repository.apache.org/content/repositories/orgapacheapex-1000/";>https://repository.apache.org/content/repositories/orgapacheapex-1000/</a></p> +<p>Copy files to distribution dir and create signatures and checksums.<br>(Note this is per policy to stage these files outside of the Maven repository, otherwise everything below would happen automatically as defined in the parent POM.)</p> +<p>For -core releases:</p> +<pre><code class="lang-bash">md5sum apex-${rv}-source-release.tar.gz > apex-${rv}-source-release.tar.gz.md5 +md5sum apex-${rv}-source-release.zip > apex-${rv}-source-release.zip.md5 +shasum -a 512 apex-${rv}-source-release.tar.gz > apex-${rv}-source-release.tar.gz.sha +shasum -a 512 apex-${rv}-source-release.zip > apex-${rv}-source-release.zip.sha +gpg --armor --output apex-${rv}-source-release.tar.gz.asc --detach-sig apex-${rv}-source-release.tar.gz +gpg --armor --output apex-${rv}-source-release.zip.asc --detach-sig apex-${rv}-source-release.zip +</code></pre> +<p>For -malhar releases:</p> +<pre><code class="lang-bash">md5sum malhar-${rv}-source-release.tar.gz > malhar-${rv}-source-release.tar.gz.md5 +md5sum malhar-${rv}-source-release.zip > malhar-${rv}-source-release.zip.md5 +shasum -a 512 malhar-${rv}-source-release.tar.gz > malhar-${rv}-source-release.tar.gz.sha +shasum -a 512 malhar-${rv}-source-release.zip > malhar-${rv}-source-release.zip.sha +gpg --armor --output malhar-${rv}-source-release.tar.gz.asc --detach-sig malhar-${rv}-source-release.tar.gz +gpg --armor --output malhar-${rv}-source-release.zip.asc --detach-sig malhar-${rv}-source-release.zip +</code></pre> +<p>Check files into the dist staging area:</p> +<pre><code class="lang-bash">mkdir svn-dist +cp ../*-source-* svn-dist/ +svn import svn-dist https://dist.apache.org/repos/dist/dev/incubator/apex/v${rv}-RC1 -m "Apache Apex v${rv}-RC1" +</code></pre> +<h2 id="voting">Voting</h2> +<p>PPMC vote call:<br><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/201510.mbox/browser";>http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/201510.mbox/browser</a></p> +<p>PPMC vote result:<br><a href="http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/201510.mbox/%3CCAKJfLDOY-SpcJfdFiJosoyZ2JidursecietvhT5AgUeX-%3Dw-Tw%40mail.gmail.com%3E";>http://mail-archives.apache.org/mod_mbox/incubator-apex-dev/201510.mbox/%3CCAKJfLDOY-SpcJfdFiJosoyZ2JidursecietvhT5AgUeX-%3Dw-Tw%40mail.gmail.com%3E</a></p> +<p>Once PPMC vote passes, another vote needs to be called for IPMC (only IPMC votes are binding).</p> +<p>IPMC vote call:<br><a href="http://mail-archives.apache.org/mod_mbox/incubator-general/201510.mbox/%3CCA%2B5xAo21vEVw5eggLmmbx4pxwkXNLysTXYa4_hyMbWnpUZSpyQ%40mail.gmail.com%3E";>http://mail-archives.apache.org/mod_mbox/incubator-general/201510.mbox/%3CCA%2B5xAo21vEVw5eggLmmbx4pxwkXNLysTXYa4_hyMbWnpUZSpyQ%40mail.gmail.com%3E</a></p> +<p>IPMC vote result:<br><a href="http://mail-archives.apache.org/mod_mbox/incubator-general/201510.mbox/%3CCA%2B5xAo2O8aqg3Z0-y0hiyq5aFskYrMDG-xYbdfQR8YGCiiGAjA%40mail.gmail.com%3E";>http://mail-archives.apache.org/mod_mbox/incubator-general/201510.mbox/%3CCA%2B5xAo2O8aqg3Z0-y0hiyq5aFskYrMDG-xYbdfQR8YGCiiGAjA%40mail.gmail.com%3E</a></p> +<p>If the vote is not successful, a new RC needs to be built. Once IPMC vote passes, proceed with promoting and announcing the release.</p> +<h2 id="promote-release">Promote Release</h2> +<p>Release Nexus staging repository: <a href="http://central.sonatype.org/pages/releasing-the-deployment.html#close-and-drop-or-release-your-staging-repository";>http://central.sonatype.org/pages/releasing-the-deployment.html#close-and-drop-or-release-your-staging-repository</a></p> +<p>Move source release from dist staging to release folder:</p> +<pre><code>svn mv https://dist.apache.org/repos/dist/dev/incubator/apex/v3.2.0-incubating-RC2 https://dist.apache.org/repos/dist/release/incubator/apex/v3.2.0-incubating +</code></pre><h3 id="jira">JIRA</h3> +<p>Close release and all associated tickets<br>Create version number X.Y.Z+1 for next release</p> +<h3 id="git">git</h3> +<p>Create final release tag:</p> +<pre><code class="lang-bash">git tag -a "v3.2.0-incubating" -m "Release 3.2.0-incubating" "v3.2.0-incubating-RC2" +git push apache "v3.2.0-incubating" +</code></pre> +<p>Bump patch version number in release branch (X.Y.Z+1 - otherwise same as when creating new release branch):</p> +<pre><code class="lang-bash">git checkout release-3.2 +dv=3.2.0-incubating-SNAPSHOT +rv=3.2.1-incubating-SNAPSHOT +for a in `git grep -l "${dv}"`; do echo $a; sed -i 's/'"${dv}"'/'"${rv}"'/g' $a; done +git commit -am "Preparing for 3.2.1 development" +</code></pre> +<p>Merge <code>@since</code> tag and change log changes to <code>devel-3</code></p> +<h2 id="announce-release">Announce Release</h2> +<p><a href="http://mail-archives.apache.org/mod_mbox/incubator-general/201511.mbox/%3CCA%2B5xAo1mS-BMT%3DXk_q287_j5m6ngtaT8QEEED0zfQhXtgrnOtA%40mail.gmail.com%3E";>http://mail-archives.apache.org/mod_mbox/incubator-general/201511.mbox/%3CCA%2B5xAo1mS-BMT%3DXk_q287_j5m6ngtaT8QEEED0zfQhXtgrnOtA%40mail.gmail.com%3E</a></p> + +</div> + + <hr> + <div class="container"> + <footer id="main-footer"> + <p> + Copyright © <span id="copyright-year">2015</span> <a href="http://apache.org";>The Apache Software Foundation</a>, + Licensed under the Apache License, Version 2.0<br> + Apache and the Apache feather logo are trademarks of The Apache Software Foundation.<br> + <a class="footer-link-img" href="http://apache.org";><img src="/images/asf-feather.png" alt="The Apache Software Foundation"></a> + <a class="footer-link-img" href="http://incubator.apache.org/";><img src="/images/incubator-egg.png" alt="Apache Incubator"></a> + </p> + <p class="text-muted"> + <small>Apache Apex is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</small> + </p> + </footer> + </div> <!-- /container --> + + <!-- Placed at the end of the document so the pages load faster --> + <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js";></script> + <script src="/js/bootstrap.min.js"></script> + <script> + $('#copyright-year').text((new Date()).getFullYear()); + </script> + +</body> +</html>
