Skip to content

Latest commit

 

History

History
70 lines (38 loc) · 2.2 KB

CONTRIBUTING.md

File metadata and controls

70 lines (38 loc) · 2.2 KB

How to Contribute

Raising an issue:

This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code style. Please report issues here Issues - fossasia/susi_android

Branch Policy

Sending pull requests:

Go to the repository on github at https://github.com/fossasia/susi_android .

Click the “Fork” button at the top right.

You’ll now have your own copy of the original FOSSASIA repository in your github account.

Open a terminal/shell.

Type

$ git clone https://github.com/username/susi_android

where 'username' is your username.

You’ll now have a local copy of your version of the original FOSSASIA repository.

Change into that project directory (susi_android):

$ cd susi_android

Add a connection to the original FOSSASIA repository.

$ git remote add upstream https://github.com/fossasia/susi_android

To check this remote add set up:

$ git remote -v

Make changes to files.

git add and git commit those changes

git push them back to github. These will go to your version of the repository.

Now Create a PR (Pull Request)

Go to your version of the repository on github.

Click the “New pull Request” button at the top.

Note that your friend’s repository will be on the left and your repository will be on the right.

Click the green button “Create pull request”. Give a succinct and informative title, in the comment field give a short explanation of the changes and click the green button “Create pull request” again.

Pulling others’ changes

Before you make further changes to the repository, you should check that your version is up to date relative to FOSSASIA’s version.

Go into the directory for the project and type:

$ git checkout development $ git pull upstream development --rebase

This will pull down and merge all of the changes that have been made in the original FOSSASIA repository.

Now push them back to your github repository.

$ git push origin development