Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 3.59 KB

CONTRIBUTING.md

File metadata and controls

57 lines (41 loc) · 3.59 KB
Raw

Contributing to AndroidTacticalAssaultKit-CIV (ATAK-CIV)

Anyone is welcome to contribute code changes and additions to this project. If you'd like your changes merged into the master branch, please read the following document before opening a pull request.

There are several ways in which you can help improve this project:

  1. Fix an existing issue and submit a pull request.
  2. Review open pull requests.
  3. Report a new issue. Only do this after you've made sure the behavior or problem you're observing isn't already documented in an open issue.

Table of Contents

Getting Started

ATAK-CIV is a andorid application and software development kit.

Making Changes

  1. Fork and clone the project's repo.
  2. Install development dependencies as in the BUILDING.md document.
  3. Create a feature branch for the code changes you're looking to make: git checkout -b your-descriptive-branch-name origin/master.
  4. Write some code!
  5. Run the application and verify that your changes function as intended: gradlew installCivDebug and gradlew installCivRelease then launch the APK for the respective results.
  6. If your changes would benefit from testing, add the necessary tests and verify everything passes by running the Test Report Task, e.g. gradlew -Pcoverage createCivDebugJacocoTestReport.
  7. Commit your changes: git commit -am 'Add some new feature or fix some issue'. (See this excellent article for tips on writing useful Git commit messages.)
  8. Push the branch to your fork: git push -u origin your-descriptive-branch-name.
  9. Create a new pull request and we'll review your changes.

Code Style

ATAK makes use of the supplied android-formatting.xml file

  1. Go to the Plugins Section of Android Studio Settings
  2. Click on Browse Repositories.
  3. Type Eclipse Code Formatter in the search box.
  4. Install and restart Android Studio
  5. Go to the Plugins Section of Android Studio Settings
  6. Select Elipse Code Formatter
  7. Then select the Code Format XML file.
  8. Click OK

Legalese

Before submitting a pull request to this repository for the first time, you'll need to sign a Developer Certificate of Origin (DCO). To read and agree to the DCO, you'll add your name and email address to CONTRIBUTORS.md. At a high level, this tells us that you have the right to submit the work you're contributing in your pull request and says that you consent to us treating the contribution in a way consistent with the license associated with this software (as described in LICENSE.md) and its documentation ("Project").

You may submit contributions anonymously or under a pseudonym if you'd like, but we need to be able to reach you at the email address you provide when agreeing to the DCO. Contributions you make to this public Department of Defense repository are completely voluntary. When you submit a pull request, you're offering your contribution without expectation of payment and you expressly waive any future pay claims against the U.S. Federal Government related to your contribution.