http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/how-to-contribute.html ---------------------------------------------------------------------- diff --git a/content/how-to-contribute.html b/content/how-to-contribute.html new file mode 100644 index 0000000..87ad4a0 --- /dev/null +++ b/content/how-to-contribute.html @@ -0,0 +1,345 @@ +<!DOCTYPE html> +<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 --> + <title>Apache Flink: How To Contribute</title> + <link rel="shortcut icon" href="/favicon.ico" type="image/x-icon"> + <link rel="icon" href="/favicon.ico" type="image/x-icon"> + + <!-- Bootstrap --> + <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap.min.css";> + <link rel="stylesheet" href="/css/flink.css"> + <link rel="stylesheet" href="/css/syntax.css"> + + <!-- Blog RSS feed --> + <link href="/blog/feed.xml" rel="alternate" type="application/rss+xml" title="Apache Flink Blog: RSS feed" /> + + <!-- jQuery (necessary for Bootstrap's JavaScript plugins) --> + <!-- We need to load Jquery in the header for custom google analytics event tracking--> + <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js";></script> + + <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> + <!-- WARNING: Respond.js doesn't work if you view the page via file:// --> + <!--[if lt IE 9]> + <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js";></script> + <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js";></script> + <![endif]--> + </head> + <body> + + + <!-- Main content. --> + <div class="container"> + <div class="row"> + + + <div id="sidebar" class="col-sm-3"> + <!-- Top navbar. --> + <nav class="navbar navbar-default"> + <!-- The logo. --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <div class="navbar-logo"> + <a href="/"> + <img alt="Apache Flink" src="/img/navbar-brand-logo.png" width="147px" height="73px"> + </a> + </div> + </div><!-- /.navbar-header --> + + <!-- The navigation links. --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-main"> + + <!-- Downloads --> + <li class=""><a class="btn btn-info" href="/downloads.html">Download Flink</a></li> + + <!-- Overview --> + <li><a href="/index.html">Home</a></li> + + <!-- Intro --> + <li><a href="/introduction.html">Introduction to Flink</a></li> + + <!-- Use cases --> + <li><a href="/usecases.html">Flink Use Cases</a></li> + + <!-- Powered by --> + <li><a href="/poweredby.html">Powered by Flink</a></li> + + <!-- Ecosystem --> + <li><a href="/ecosystem.html">Ecosystem</a></li> + + <!-- Community --> + <li><a href="/community.html">Community & Project Info</a></li> + + <!-- Contribute --> + <li class="active"><a href="/how-to-contribute.html">How to Contribute</a></li> + + <!-- Blog --> + <li class=" hidden-md hidden-sm"><a href="/blog/"><b>Flink Blog</b></a></li> + + <hr /> + + + + <!-- Documentation --> + <!-- <li> + <a href="http://ci.apache.org/projects/flink/flink-docs-release-1.1"; target="_blank">Documentation <small><span class="glyphicon glyphicon-new-window"></span></small></a> + </li> --> + <li class="dropdown"> + <a class="dropdown-toggle" data-toggle="dropdown" href="#">Documentation + <span class="caret"></span></a> + <ul class="dropdown-menu"> + <li><a href="http://ci.apache.org/projects/flink/flink-docs-release-1.1"; target="_blank">1.1 (Latest stable release) <small><span class="glyphicon glyphicon-new-window"></span></small></a></li> + <li><a href="http://ci.apache.org/projects/flink/flink-docs-release-1.2"; target="_blank">1.2 (Snapshot) <small><span class="glyphicon glyphicon-new-window"></span></small></a></li> + </ul> + </li> + + <!-- Quickstart --> + <li> + <a href="http://ci.apache.org/projects/flink/flink-docs-release-1.1/quickstart/setup_quickstart.html"; target="_blank">Quickstart <small><span class="glyphicon glyphicon-new-window"></span></small></a> + </li> + + <!-- GitHub --> + <li> + <a href="https://github.com/apache/flink"; target="_blank">Flink on GitHub <small><span class="glyphicon glyphicon-new-window"></span></small></a> + </li> + + + + + + + </ul> + + + + <ul class="nav navbar-nav navbar-bottom"> + <hr /> + + <!-- FAQ --> + <li ><a href="/faq.html">Project FAQ</a></li> + + <!-- Twitter --> + <li><a href="https://twitter.com/apacheflink"; target="_blank">@ApacheFlink <small><span class="glyphicon glyphicon-new-window"></span></small></a></li> + + <!-- Visualizer --> + <li class=" hidden-md hidden-sm"><a href="/visualizer/" target="_blank">Plan Visualizer <small><span class="glyphicon glyphicon-new-window"></span></small></a></li> + + </ul> + </div><!-- /.navbar-collapse --> + </nav> + + </div> + <div class="col-sm-9"> + <div class="row-fluid"> + <div class="col-sm-12"> + <h1>How To Contribute</h1> + + <p>Apache Flink is developed by an open and friendly community. Everybody is cordially welcome to join the community and contribute to Apache Flink. There are several ways to interact with the community and to contribute to Flink including asking questions, filing bug reports, proposing new features, joining discussions on the mailing lists, contributing code or documentation, improving the website, or testing release candidates.</p> + +<div class="page-toc"> +<ul id="markdown-toc"> + <li><a href="#ask-questions" id="markdown-toc-ask-questions">Ask questions!</a></li> + <li><a href="#file-a-bug-report" id="markdown-toc-file-a-bug-report">File a bug report</a></li> + <li><a href="#propose-an-improvement-or-a-new-feature" id="markdown-toc-propose-an-improvement-or-a-new-feature">Propose an improvement or a new feature</a></li> + <li><a href="#help-others-and-join-the-discussions" id="markdown-toc-help-others-and-join-the-discussions">Help others and join the discussions</a></li> + <li><a href="#test-a-release-candidate" id="markdown-toc-test-a-release-candidate">Test a release candidate</a></li> + <li><a href="#contribute-code" id="markdown-toc-contribute-code">Contribute code</a></li> + <li><a href="#contribute-documentation" id="markdown-toc-contribute-documentation">Contribute documentation</a></li> + <li><a href="#improve-the-website" id="markdown-toc-improve-the-website">Improve the website</a></li> + <li><a href="#more-ways-to-contribute" id="markdown-toc-more-ways-to-contribute">More ways to contributeâ¦</a></li> + <li><a href="#submit-a-contributor-license-agreement" id="markdown-toc-submit-a-contributor-license-agreement">Submit a Contributor License Agreement</a></li> + <li><a href="#how-to-become-a-committer" id="markdown-toc-how-to-become-a-committer">How to become a committer</a></li> +</ul> + +</div> + +<h2 id="ask-questions">Ask questions!</h2> + +<p>The Apache Flink community is eager to help and to answer your questions. We have a <a href="/community.html#mailing-lists">user mailing list</a>, hang out in an <a href="/community.html#irc">IRC channel</a>, and watch Stack Overflow on the <a href="http://stackoverflow.com/questions/tagged/apache-flink";>[apache-flink]</a> tag.</p> + +<hr /> + +<h2 id="file-a-bug-report">File a bug report</h2> + +<p>Please let us know if you experienced a problem with Flink and file a bug report. Open <a href="http://issues.apache.org/jira/browse/FLINK";>Flinkâs JIRA</a> and click on the blue <strong>Create</strong> button at the top. Please give detailed information about the problem you encountered and, if possible, add a description that helps to reproduce the problem. Thank you very much.</p> + +<hr /> + +<h2 id="propose-an-improvement-or-a-new-feature">Propose an improvement or a new feature</h2> + +<p>Our community is constantly looking for feedback to improve Apache Flink. If you have an idea how to improve Flink or have a new feature in mind that would be beneficial for Flink users, please open an issue in <a href="http://issues.apache.org/jira/browse/FLINK";>Flinkâs JIRA</a>. The improvement or new feature should be described in appropriate detail and include the scope and its requirements if possible. Detailed information is important for a few reasons:</p> + +<ul> + <li>It ensures your requirements are met when the improvement or feature is implemented.</li> + <li>It helps to estimate the effort and to design a solution that addresses your needs.</li> + <li>It allow for constructive discussions that might arise around this issue.</li> +</ul> + +<p>Detailed information is also required, if you plan to contribute the improvement or feature you proposed yourself. Please read the <a href="/contribute-code.html">Contribute code</a> guide in this case as well.</p> + +<p>We recommend to first reach consensus with the community on whether a new feature is required and how to implement a new feature, before starting with the implementation. Some features might be out of scope of the project, and itâs best to discover this early.</p> + +<p>For very big features that change Flink in a fundamental way we have another process in place: +<a href="https://cwiki.apache.org/confluence/display/FLINK/Flink+Improvement+Proposals";>Flink Improvement Proposals</a>. If you are interested you can propose a new feature there or follow the +discussions on existing proposals.</p> + +<hr /> + +<h2 id="help-others-and-join-the-discussions">Help others and join the discussions</h2> + +<p>Most communication in the Apache Flink community happens on two mailing lists:</p> + +<ul> + <li>The user mailing lists <code>u...@flink.apache.org</code> is the place where users of Apache Flink ask questions and seek for help or advice. Joining the user list and helping other users is a very good way to contribute to Flinkâs community. Furthermore, there is the <a href="http://stackoverflow.com/questions/tagged/apache-flink";>[apache-flink]</a> tag on Stack Overflow if youâd like to help Flink users (and harvest some points) there.</li> + <li>The development mailing list <code>d...@flink.apache.org</code> is the place where Flink developers exchange ideas and discuss new features, upcoming releases, and the development process in general. If you are interested in contributing code to Flink, you should join this mailing list.</li> +</ul> + +<p>You are very welcome to <a href="/community.html#mailing-lists">subscribe to both mailing lists</a>. In addition to the user list, there is also a <a href="/community.html#irc">Flink IRC</a> channel that you can join to talk to other users and contributors.</p> + +<hr /> + +<h2 id="test-a-release-candidate">Test a release candidate</h2> + +<p>Apache Flink is continuously improved by its active community. Every few weeks, we release a new version of Apache Flink with bug fixes, improvements, and new features. The process of releasing a new version consists of the following steps:</p> + +<ol> + <li>Building a new release candidate and starting a vote (usually for 72 hours).</li> + <li>Testing the release candidate and voting (<code>+1</code> if no issues were found, <code>-1</code> if the release candidate has issues).</li> + <li>Going back to step 1 if the release candidate had issues otherwise we publish the release.</li> +</ol> + +<p>Our wiki contains a page that summarizes the <a href="https://cwiki.apache.org/confluence/display/FLINK/Releasing";>test procedure for a release</a>. Release testing is a big effort if done by a small group of people but can be easily scaled out to more people. The Flink community encourages everybody to participate in the testing of a release candidate. By testing a release candidate, you can ensure that the next Flink release is working properly for your setup and help to improve the quality of releases.</p> + +<hr /> + +<h2 id="contribute-code">Contribute code</h2> + +<p>Apache Flink is maintained, improved, and extended by code contributions of volunteers. The Apache Flink community encourages anybody to contribute source code. In order to ensure a pleasant contribution experience for contributors and reviewers and to preserve the high quality of the code base, we follow a contribution process that is explained in our <a href="/contribute-code.html">Contribute code</a> guide. The guide does also include instructions to setup a development environment, our coding guidelines and code style, and explains how to submit a code contribution.</p> + +<p><strong>Please read the <a href="/contribute-code.html">Contribute code</a> guide before you start to work on a code contribution.</strong></p> + +<p>Please do also read the <a href="/how-to-contribute.html#submit-a-contributor-license-agreement">Submit a Contributor License Agreement</a> Section.</p> + +<h3 class="no_toc" id="looking-for-an-issue-to-work-on">Looking for an issue to work on?</h3> + +<p>We maintain a list of all known bugs, proposed improvements and suggested features in <a href="https://issues.apache.org/jira/browse/FLINK/?selectedTab=com.atlassian.jira.jira-projects-plugin:issues-panel";>Flinkâs JIRA</a>. Issues that we believe are good tasks for new contributors are tagged with a special âstarterâ tag. Those tasks are supposed to be rather easy to solve and will help you to become familiar with the project and the contribution process.</p> + +<p>Please have a look at the list of <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FLINK%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20starter%20ORDER%20BY%20priority%20DESC";>starter issues</a>, if you are looking for an issue to work on. You can of course also choose <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20FLINK%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20priority%20DESC";>any other issue</a> to work on. Feel free to ask questions about issues that you would be interested in working on.</p> + +<hr /> + +<h2 id="contribute-documentation">Contribute documentation</h2> + +<p>Good documentation is crucial for any kind of software. This is especially true for sophisticated software systems such as distributed data processing engines like Apache Flink. The Apache Flink community aims to provide concise, precise, and complete documentation and welcomes any contribution to improve Apache Flinkâs documentation.</p> + +<ul> + <li>Please report missing, incorrect, or out-dated documentation as a <a href="http://issues.apache.org/jira/browse/FLINK";>JIRA issue</a>.</li> + <li>Flinkâs documentation is written in Markdown and located in the <code>docs</code> folder in <a href="/community.html#main-source-repositories">Flinkâs source code repository</a>. See the <a href="/contribute-documentation.html">Contribute documentation</a> guidelines for detailed instructions for how to update and improve the documentation and to contribute your changes.</li> +</ul> + +<hr /> + +<h2 id="improve-the-website">Improve the website</h2> + +<p>The <a href="http://flink.apache.org";>Apache Flink website</a> presents Apache Flink and its community. It serves several purposes including:</p> + +<ul> + <li>Informing visitors about Apache Flink and its features.</li> + <li>Encouraging visitors to download and use Flink.</li> + <li>Encouraging visitors to engage with the community.</li> +</ul> + +<p>We welcome any contribution to improve our website.</p> + +<ul> + <li>Please open a <a href="http://issues.apache.org/jira/browse/FLINK";>JIRA issue</a> if you think our website could be improved.</li> + <li>Please follow the <a href="/improve-website.html">Improve the website</a> guidelines if you would like to update and improve the website.</li> +</ul> + +<hr /> + +<h2 id="more-ways-to-contribute">More ways to contributeâ¦</h2> + +<p>There are many more ways to contribute to the Flink community. For example you can</p> + +<ul> + <li>give a talk about Flink and tell others how you use it.</li> + <li>organize a local Meetup or user group.</li> + <li>talk to people about Flink.</li> + <li>â¦</li> +</ul> + +<hr /> + +<h2 id="submit-a-contributor-license-agreement">Submit a Contributor License Agreement</h2> + +<p>Please submit a contributor license agreement to the Apache Software Foundation (ASF) if you would like to contribute to Apache Flink. The following quote from <a href="http://www.apache.org/licenses/#clas";>http://www.apache.org/licenses</a> gives more information about the ICLA and CCLA and why they are necessary.</p> + +<blockquote> + <p>The ASF desires that all contributors of ideas, code, or documentation to the Apache projects complete, sign, and submit (via postal mail, fax or email) an <a href="http://www.apache.org/licenses/icla.txt";>Individual Contributor License Agreement</a> (CLA) [ <a href="http://www.apache.org/licenses/icla.pdf";>PDF form</a> ]. The purpose of this agreement is to clearly define the terms under which intellectual property has been contributed to the ASF and thereby allow us to defend the project should there be a legal dispute regarding the software at some future time. A signed CLA is required to be on file before an individual is given commit rights to an ASF project.</p> + + <p>For a corporation that has assigned employees to work on an Apache project, a <a href="http://www.apache.org/licenses/cla-corporate.txt";>Corporate CLA</a> (CCLA) is available for contributing intellectual property via the corporation, that may have been assigned as part of an employment agreement. Note that a Corporate CLA does not remove the need for every developer to sign their own CLA as an individual, to cover any of their contributions which are not owned by the corporation signing the CCLA.</p> + + <p>â¦</p> +</blockquote> + +<hr /> + +<h2 id="how-to-become-a-committer">How to become a committer</h2> + +<p>Committers are community members that have write access to the projectâs repositories, i.e., they can modify the code, documentation, and website by themselves and also accept other contributions.</p> + +<p>There is no strict protocol for becoming a committer. Candidates for new committers are typically people that are active contributors and community members.</p> + +<p>Being an active community member means participating on mailing list discussions, helping to answer questions, verifying release candidates, being respectful towards others, and following the meritocratic principles of community management. Since the âApache Wayâ has a strong focus on the project community, this part is <em>very</em> important.</p> + +<p>Of course, contributing code and documentation to the project is important as well. A good way to start is contributing improvements, new features, or bug fixes. You need to show that you take responsibility for the code that you contribute, add tests and documentation, and help maintaining it.</p> + +<p>Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC.</p> + +<p>If you would like to become a committer, you should engage with the community and start contributing to Apache Flink in any of the above ways. You might also want to talk to other committers and ask for their advice and guidance.</p> + + + </div> +</div> + + </div> + </div> + + <hr /> + + <div class="row"> + <div class="footer text-center col-sm-12"> + <p>Copyright © 2014-2016 <a href="http://apache.org";>The Apache Software Foundation</a>. All Rights Reserved.</p> + <p>Apache Flink, Apache, and the Apache feather logo are either registered trademarks or trademarks of The Apache Software Foundation.</p> + <p><a href="/privacy-policy.html">Privacy Policy</a> · <a href="/blog/feed.xml">RSS feed</a></p> + </div> + </div> + </div><!-- /.container --> + + <!-- Include all compiled plugins (below), or include individual files as needed --> + <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js";></script> + <script src="/js/codetabs.js"></script> + <script src="/js/stickysidebar.js"></script> + + + <!-- Google Analytics --> + <script> + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) + })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); + + ga('create', 'UA-52545728-1', 'auto'); + ga('send', 'pageview'); + </script> + </body> +</html>
http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/alibaba-logo.png ---------------------------------------------------------------------- diff --git a/content/img/alibaba-logo.png b/content/img/alibaba-logo.png new file mode 100644 index 0000000..09c720c Binary files /dev/null and b/content/img/alibaba-logo.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/WhatIsFlink.png ---------------------------------------------------------------------- diff --git a/content/img/assets/WhatIsFlink.png b/content/img/assets/WhatIsFlink.png new file mode 100755 index 0000000..20014c5 Binary files /dev/null and b/content/img/assets/WhatIsFlink.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/grep.png ---------------------------------------------------------------------- diff --git a/content/img/assets/grep.png b/content/img/assets/grep.png new file mode 100755 index 0000000..d4e657c Binary files /dev/null and b/content/img/assets/grep.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/hadoop-img.png ---------------------------------------------------------------------- diff --git a/content/img/assets/hadoop-img.png b/content/img/assets/hadoop-img.png new file mode 100755 index 0000000..d47c024 Binary files /dev/null and b/content/img/assets/hadoop-img.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/optimizer-visual.png ---------------------------------------------------------------------- diff --git a/content/img/assets/optimizer-visual.png b/content/img/assets/optimizer-visual.png new file mode 100755 index 0000000..654c127 Binary files /dev/null and b/content/img/assets/optimizer-visual.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/pagerank.pdf ---------------------------------------------------------------------- diff --git a/content/img/assets/pagerank.pdf b/content/img/assets/pagerank.pdf new file mode 100755 index 0000000..6bcc432 Binary files /dev/null and b/content/img/assets/pagerank.pdf differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/assets/pagerank.png ---------------------------------------------------------------------- diff --git a/content/img/assets/pagerank.png b/content/img/assets/pagerank.png new file mode 100755 index 0000000..989564e Binary files /dev/null and b/content/img/assets/pagerank.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/GSA-plan.png ---------------------------------------------------------------------- diff --git a/content/img/blog/GSA-plan.png b/content/img/blog/GSA-plan.png new file mode 100644 index 0000000..980e4f3 Binary files /dev/null and b/content/img/blog/GSA-plan.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/appeared-in.png ---------------------------------------------------------------------- diff --git a/content/img/blog/appeared-in.png b/content/img/blog/appeared-in.png new file mode 100644 index 0000000..606da9e Binary files /dev/null and b/content/img/blog/appeared-in.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/blog_basic_window.png ---------------------------------------------------------------------- diff --git a/content/img/blog/blog_basic_window.png b/content/img/blog/blog_basic_window.png new file mode 100755 index 0000000..8ad3f4f Binary files /dev/null and b/content/img/blog/blog_basic_window.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/blog_data_driven.png ---------------------------------------------------------------------- diff --git a/content/img/blog/blog_data_driven.png b/content/img/blog/blog_data_driven.png new file mode 100755 index 0000000..81a83ac Binary files /dev/null and b/content/img/blog/blog_data_driven.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/blog_multi_input.png ---------------------------------------------------------------------- diff --git a/content/img/blog/blog_multi_input.png b/content/img/blog/blog_multi_input.png new file mode 100755 index 0000000..bde635d Binary files /dev/null and b/content/img/blog/blog_multi_input.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/blog_social_media.png ---------------------------------------------------------------------- diff --git a/content/img/blog/blog_social_media.png b/content/img/blog/blog_social_media.png new file mode 100755 index 0000000..c1a7e0f Binary files /dev/null and b/content/img/blog/blog_social_media.png differ http://git-wip-us.apache.org/repos/asf/flink-web/blob/9ec0a879/content/img/blog/blog_stream_join.png ---------------------------------------------------------------------- diff --git a/content/img/blog/blog_stream_join.png b/content/img/blog/blog_stream_join.png new file mode 100755 index 0000000..ee7e7c0 Binary files /dev/null and b/content/img/blog/blog_stream_join.png differ
