貢献は歓迎されます!

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.

質問!

The Apache Flink community is eager to help and to answer your questions. We have a user mailing list, hang out in an IRC channel, and watch Stack Overflow on the [apache-flink] tag.


バグレポートの提出

Please let us know if you experienced a problem with Flink and file a bug report. Open Flink’s JIRA and click on the blue Create button at the top. もし可能であれば問題を再現するのに役立つ説明を追加し、遭遇した問題についての詳細な情報をください。ありがとう。


改善あるいは新しい機能の提案

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 Flink’s JIRA. 改善あるいは新しい機能は適切な詳細さで説明され、可能であればスコープと要求を含む必要があります。2、3の理由で詳細な情報が重要です:

  • 改善あるいは機能が実装された場合に、あなたの要求が一致することを確実にする。
  • 努力の評価とあなたが必要とする解決方法の設計をするのに役立ちます。
  • この問題について起こるかも知れない議論について建設的なものにすることができます。

あなたが提案する改善や機能についてあなた自身が貢献する予定であれば、詳細な情報も必要とされます。Please read the Contribute code guide in this case as well.

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.


Help others and join the discussions

Most communication in the Apache Flink community happens on two mailing lists:

  • The user mailing lists user@flink.apache.org 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 [apache-flink] tag on Stack Overflow if you’d like to help Flink users (and harvest some points) there.
  • The development mailing list dev@flink.apache.org 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.

You are very welcome to subscribe to both mailing lists. In addition to the user list, there is also a Flink IRC channel that you can join to talk to other users and contributors.


リリース候補のテスト

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:

  1. Building a new release candidate and starting a vote (usually for 72 hours).
  2. Testing the release candidate and voting (+1 if no issues were found, -1 if the release candidate has issues).
  3. Going back to step 1 if the release candidate had issues otherwise we publish the release.

Our wiki contains a page that summarizes the test procedure for a release. 少ない人のグループでリリーステストをすることは大きな努力が必要ですが、もっと多くの人に簡単にスケールアウトすることができます。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.


コードの貢献

Apache Flink はボランティアのコードの貢献によって、維持、改善および拡張されます。Apache Flink コミュニティは皆のソースコードの貢献を推奨します。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 Contribute code 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.

Please read the Contribute code guide before you start to work on a code contribution.

Please do also read the Submit a Contributor License Agreement Section.

動作させるために問題を探す?

We maintain a list of all known bugs, proposed improvements and suggested features in Flink’s JIRA. 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.

Please have a look at the list of starter issues, if you are looking for an issue to work on. You can of course also choose any other issue to work on. 動作のために興味がある問題について気軽に質問をしてください。


ドキュメントへの貢献

どのような種類のソフトウェアにとっても良いドキュメントは重要です。Apache Flinkのような分散データ処理エンジンのような洗練されたソフトウェアシステムにとって特にそれが当てはまります。Apache Flinkのコミュニティは完結、正確、そして完全なドキュメントを提供しようと狙っており、Apache Flinkのドキュメントを改善するどのような貢献も歓迎します。

  • Please report missing, incorrect, or out-dated documentation as a JIRA issue.
  • Flink’s documentation is written in Markdown and located in the docs folder in Flink’s source code repository. See the Contribute documentation guidelines for detailed instructions for how to update and improve the documentation and to contribute your changes.

webサイトの改善

Apache Flink webサイト はApache Flinkとそのコミュニティを紹介します。それは以下のいくつかの目的に役立ちます:

  • 訪問者にApache Flinkとその機能の情報を与えます。
  • 訪問者がFlinkをダウンロードし使うように勧めます。
  • 訪問者にコミュニティに参加するように勧める。

webサイトを改善するどのような貢献も歓迎します。

  • Please open a JIRA issue if you think our website could be improved.
  • Please follow the Improve the website guidelines if you would like to update and improve the website.

貢献するためのもっと多くの方法・・・

There are many more ways to contribute to the Flink community. 例えば、以下のことができます

  • give a talk about Flink and tell others how you use it.
  • ローカルのMeetupあるいはユーザグループを組織する
  • talk to people about Flink.

Submit a Contributor License Agreement

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 http://www.apache.org/licenses gives more information about the ICLA and CCLA and why they are necessary.

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 Individual Contributor License Agreement (CLA) [ PDF form ]. 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.

For a corporation that has assigned employees to work on an Apache project, a Corporate CLA (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.


How to become a committer

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.

There is no strict protocol for becoming a committer. Candidates for new committers are typically people that are active contributors and community members.

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 very important.

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.

Candidates for new committers are suggested by current committers or PMC members, and voted upon by the PMC.

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.


TOP
inserted by FC2 system