Skip to end of metadata
Go to start of metadata

This guide documents the best way to make various types of contribution to Apache Eagle (incubating), including what is required before submitting a code change.

Contributing to Eagle doesn't just mean writing code. Helping new users on the mailing list, testing releases, and improving documentation are also welcome. In fact, proposing significant code changes usually requires first gaining experience and credibility within the community by helping in other ways. This is also a guide to becoming an effective contributor.


Before Making Contribution

Before contributing, you should know that Apache Eagle (incubating) is using

Contributing by Helping Other Users

A great way to contribute to Eagle is to help answer user questions on the user@eagle.incubator.apache.org mailing list. There are always many new Eagle users; taking a few minutes to help answer a question is a very valuable community service.

Contributors should subscribe to this list and follow it in order to keep up to date on what's happening in Eagle. Answering questions is an excellent and visible way to help the community, which also demonstrates your expertise.

Contributing by Reviewing Changes

Changes to Eagle source code are proposed, reviewed and committed via Github (described later) at https://github.com/apache/incubator-eagle/pulls. Anyone can view and comment on active changes here. Reviewing others' changes is a good way to learn how the change process works and gain exposure to activity in various parts of the code. You can help by reviewing the changes and asking questions or pointing out issues -- as simple as typos or small issues of style.

Contributing Documentation Changes

Apache Eagle documentations are mainly host on:

You could make contribution 

Contributing Bug Reports

Contributing Code Changes

When you contribute code, you affirm that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so.

This section to help anyone who want to involve and contribute code to eagle project. Apache site have great documentation on how apache build the community and help the open source project. If one wants to know more detail on how apache works, he/she might want to check http://community.apache.org/.

JIRA

For who is new to eagle project, we have a label "new" to start with.

Loading
T Key Summary Assignee Reporter P Status Resolution Created Updated Due
New Feature EAGLE-251 Run eagle on flink/samza Unassigned Su Ralph Minor Open Unresolved Apr 13, 2016 Dec 14, 2017
New Feature EAGLE-250 Metadata on mongodb Su Ralph Su Ralph Minor Resolved Fixed Apr 13, 2016 Oct 12, 2016
Improvement EAGLE-241 Beautify script output or logs Hao Chen Hao Chen Minor Resolved Fixed Apr 12, 2016 Oct 08, 2016
New Feature EAGLE-234 Clean maven build warning in eagle Michael Wu Hao Chen Major Open Unresolved Apr 11, 2016 Jul 20, 2017
Improvement EAGLE-196 eagle-topology.sh should have jar file path as parameter Zhao, Qingwen Edward Zhang Minor Resolved Fixed Mar 10, 2016 Apr 13, 2016
New Feature EAGLE-135 Run Eagle in Spark Streaming Zhaokun Qin Zhaokun Qin Minor Open Unresolved Jan 21, 2016 Aug 17, 2016

Pull Request

If you are ready to contribute code change. Here in this page we just focus on a consistent dev process to keep the project run smoothly.

  1. Find the existing Eagle JIRA that the change pertains to. If confirmed the change is new, create a new JIRA ticket if required with required fields
    • Issue Type
    • Priority
    • Affects Version
  2. Fork one's own feature branch from eagle official github (https://github.com/apache/incubator-eagle/)
  3. Fix bug / Develop feature in the feature branch. One might have multiple
  4. After development is done, send a github pull request. Like https://github.com/apache/incubator-eagle/pull/19. NOTE: Please make sure the pull request title is in format of EAGLE-${ticket_number} ${ticket_title}, so that ASF bot could help sync the pull request comments to JIRA automatically.

Review Process

The review process is for Apache Eagle committer only.

The committer should follow below process to review the contribution and merge the code.

  1. Review: Committers should review the pull request changes, leave comments and sigh off about whether accept the code change. (Reject/Recall/Pass)

  2. Merge: merge the patch of the pull request and push the merged code to apache/incubbator-eagle (following process is temporary solution for manual merging, the automatic tool is under development  EAGLE-84)

    Pre-requisite

    Committer(reviewer) should have already cloned repo from apache github

    git clone https://git-wip-us.apache.org/repos/asf/incubator-eagle.git

    git-apply 

    git-rebase when necessary

    Or git-reset

    Committers should follow an convention format to add appropriate commit message. The format should be:

     

  3. Close: Committer to close the JIRA ticket. (Pull request will be close automatically)

 

Here is a diagram to show the workflow above:

  • No labels