mirrors/nextcloud-android
1
0
Fork 0
mirror of https://github.com/nextcloud/android.git synced 2024-11-23 21:55:48 +03:00
Code Issues Projects Releases Packages Wiki Activity
nextcloud-android/CONTRIBUTING.md
David A. Velasco d5f1dc8b45 Reviewed and updated project setup instructions
2015-06-15 12:33:03 +02:00

3.8 KiB
Raw Blame History

Submitting issues

If you have questions about how to use ownCloud, please direct these to the mailing list or our forum. We are also available on IRC.

Guidelines

  • Report the issue using our template, it includes all the informations we need to track down the issue.
  • This repository is only for issues within the ownCloud Android app code. Issues in other compontents should be reported in their own repositores:
  • Search the existing issues first, it's likely that your issue was already reported.

If your issue appears to be a bug, and hasn't been reported, open a new issue.

Help us to maximize the effort we can spend fixing issues and adding new features, by not reporting duplicate issues.

Contributing to Source Code

Thanks for wanting to contribute source code to ownCloud. That's great!

Before we're able to merge your code into the ownCloud app for Android, you need to sign our Contributor Agreement.

Guidelines

  • Contribute your code in the branch 'develop'. It will give us a better chance to test your code before merging it with stable code.
  • For your first contribution, start a pull request on develop and send us the signed Contributor Agreement.
  • Keep on using pull requests for your next contributions although you own write permissions.

1. Fork and download android/develop repository:

NOTE: You must have the git installation folder in your environment variable PATH to perform the next operations.

  • In a web browser, go to https://github.com/owncloud/android, and click the 'Fork' button near the top right corner.
  • In a command line prompt, clone your new repo: git clone git@github.com:YOURGITHUBNAME/android.git.
  • Move to the project folder with cd android.
  • Checkout the remote branch 'develop' in your own local branch: git checkout -b develop remotes/origin/develop.
  • Pull any changes from your remote branch 'develop': git pull origin develop
  • Make official ownCloud repo known as upstream: git remote add upstream git@github.com:owncloud/android.git
  • Make sure to get the latest changes from official android/develop branch: git pull upstream develop

7. Create pull request:

NOTE: You must sign the [Contributor Agreement][1] before your changes can be accepted!

  • Commit your changes locally: "git commit -a"
  • Push your changes to your GitHub repo: "git push"
  • Browse to https://github.com/YOURGITHUBNAME/android/pulls and issue pull request
  • Click "Edit" and set "base:develop"
  • Again, click "Edit" and set "compare:develop"
  • Enter description and send pull request.

8. Create another pull request:

To make sure your new pull request does not contain commits which are already contained in previous PRs, create a new branch which is a clone of upstream/develop.

  • git fetch upstream
  • git checkout -b my_new_develop_branch upstream/develop
  • If you want to rename that branch later: "git checkout -b my_new_develop_branch_with_new_name"
  • Push branch to server: "git push -u origin name_of_local_develop_branch"
  • Use GitHub to issue PR

Translations

Please submit translations via Transifex.