How to contribute to Astro - ravipesala/astro GitHub Wiki

The document describes the way of contributing to Astro, it includes contributing code, helping other user queries, reviewing code changes, testing releases and improving documentation

Contributing Code changes

Issue tracking and logging

Currently Astro uses github issues portal https://github.com/HuaweiBigData/astro/issues to track issues, including bugs and improvements.

  • Before log the issue, please check whether the similar issue is already logged by some other user.
  • If issue is new, create new issue and give detailed description and supporting test code and log information.
  • If it is new feature, better to include design document.
  • Users can create pull request and add the pull request link to the issue/feature.

Creating Pull Request

  • Fork the Github repository at https://github.com/HuaweiBigData/astro if you haven't already.
  • Clone your fork, create a new branch, push commits to the branch.
  • Consider whether documentation or tests need to be added or updated as part of the change, and add them as needed.
  • Run all test cases using mvn -Phbase,hadoop-2.4 test to verify all test cases are passing with new code changes.
  • Open a pull request against the master branch of apache/spark.

Reviewing code changes

  • Other reviewers, including committers, may comment on the changes and suggest modifications. Changes can be added by simply pushing more commits to the same branch.
  • At least two reviewers vote with “+1” before changes are merged to branch.

Contributing by helping other users

Users can use github issues portal https://github.com/HuaweiBigData/astro/issues to log the query and also help other users by answering their queries.

Contributing by testing and log the defects

Users can take the latest release from github https://github.com/HuaweiBigData/astro and test the release and log the issues in https://github.com/HuaweiBigData/astro/issues portal.

Contributing by reviewing changes

Users can review the pull requests and give review comments via github.