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.
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、３の理由で詳細な情報が重要です:
あなたが提案する改善や機能についてあなた自身が貢献する予定であれば、詳細な情報も必要とされます。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.
Most communication in the Apache Flink community happens on two mailing lists:
firstname.lastname@example.org 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.
email@example.com 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.
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:
+1if no issues were found,
-1if the release candidate has issues).
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.
どのような種類のソフトウェアにとっても良いドキュメントは重要です。Apache Flinkのような分散データ処理エンジンのような洗練されたソフトウェアシステムにとって特にそれが当てはまります。Apache Flinkのコミュニティは完結、正確、そして完全なドキュメントを提供しようと狙っており、Apache Flinkのドキュメントを改善するどのような貢献も歓迎します。
docsfolder 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.
Apache Flink webサイト はApache Flinkとそのコミュニティを紹介します。それは以下のいくつかの目的に役立ちます:
There are many more ways to contribute to the Flink community. 例えば、以下のことができます
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.
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.