Difference between revisions of "Contributing"
Line 30: | Line 30: | ||
# '''git fetch upstream''' | # '''git fetch upstream''' | ||
# checkout a new branch based on the development branch (master):<br/>'''git checkout -b my_new_feature upstream/master''' | # checkout a new branch based on the development branch (master):<br/>'''git checkout -b my_new_feature upstream/master''' | ||
# fix/code and commit in logical units | # fix/code and commit in logical units (with a [http://bit.ly/goodcommitmessages good commit message]) | ||
# push your feature/bugfix branch | # push your feature/bugfix branch | ||
# Send us a [http://help.github.com/pull-requests/ pull request] on github. (Or send patches to the mailing list). | # Send us a [http://help.github.com/pull-requests/ pull request] on github. (Or send patches to the mailing list). |
Revision as of 04:04, 12 November 2014
How to contribute
It would be fantastic if you add you share to enhance the Paparazzi project. Help is always very welcome for aspects of the project. May this be documentation, wiki, maintenance, electronics or code contributions and fixes. There are lots of ways to contribute to Paparazzi and get involved.
This page will give you a headstart to be able to contribute.
Wiki
Just create an account and you can start adding information, cleaning it up or just fixing some typo you just noticed :-)
Some information and links on how to edit the wiki can be found at Help:Editing.
Please be aware of past edits and page histories. Try not to remove this; if you are moving/renaming a page, use the move tab at the top of a page. This ensures the revision history is moved with the page.
Software development
We use the distributed version control system git. The Papaprazzi master repository is hosted on Github.
Also see the Git wiki page for more details about setting up Git and cloning the source-code and data repository.
Please also have a look at the Coding Style Guide.
Here is the short version if you already know git:
- Create an account on github.
- Fork the papaprazzi repo on github. (After logging in press the fork button).
- If you want to clone with SSH: git clone git@github.com:<yourname>/paparazzi.git
Or with HTTPS: git clone https://github.com/<yourname>/paparazzi.git - git remote add upstream https://github.com/paparazzi/paparazzi.git
- git fetch upstream
- checkout a new branch based on the development branch (master):
git checkout -b my_new_feature upstream/master - fix/code and commit in logical units (with a good commit message)
- push your feature/bugfix branch
- Send us a pull request on github. (Or send patches to the mailing list).
Defects and Features
To report Paparazzi defect, various issues and to submit a feature request use the simple issue tracker on github.
Continuous Integration Builds
There is a build server running quite some Continuous Integration tests.