blob: 9d11904f32c28584b4bee3ac32916134932dc436 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
# Contributing
Welcome to Navit! If you are interested in contributing to the [Navit code repo](README.md)
then checkout the [Wiki](https://wiki.navit-project.org/index.php/Main_Page)
When pushing a pull request, please make sure you follow our:
* [programming guidelines](https://wiki.navit-project.org/index.php/Programming_guidelines)
* [commit message guidelines](https://wiki.navit-project.org/index.php/Commit_guidelines)
For more information on our development process, see: https://wiki.navit-project.org/index.php/Development
## Submitting patches
We are very happy that you like to participate and help the [[team]] to improve Navit :) To make this teamwork a pleasure for all, we will try to guide you trough this process:
### Preparation
Make sure you are familar with our (development tips)[https://wiki.navit-project.org/index.php/Development], learned about the codebase and our guidelines.
If you found a bug, please open a [GitHub issue](https://github.com/navit-gps/navit/issues) and bring up all details so others can check them and help you on isolating the defective code.
Point out that you like to submit a patch.
### Process
* Fork the [Github repository](https://github.com/navit-gps/navit) and clone it using `git clone`
* Find the bug (and please address only one issue per patch!) and try to fix it
* Test test test if still compiles and the behaviour is as expected
* Think about possible side effects (as performance, different settings, ...)
* Get the newest Git Navit version (see [this documentation](https://help.github.com/en/articles/syncing-a-fork) on how to sync your fork) and apply your changes once more
* Test if everything still works fine
* [Create a pull request](https://help.github.com/articles/creating-a-pull-request/) on github
* Wait to verify that all the tests in our CI finish successfully
### Review
It might take some time until somebody reviews the pull request (maybe try to reach out using one of the various ccontact methods [listed in the wiki](https://wiki.navit-project.org/index.php/Contacts)).
If your changes are more complex, catch up new ideas, or still have some minor problems, it might be discussed and we might ask you to submit an updated version/adapt your changes.
So that's it, you helped Navit to go one step forward. Thank you very much :)
## See also
* [programming guidelines](https://wiki.navit-project.org/index.php/Programming_guidelines)
* [commit message guidelines](https://wiki.navit-project.org/index.php/Commit_guidelines)
* [Reporting Bugs](https://wiki.navit-project.org/index.php/Reporting_Bugs)
* [Translations](https://wiki.navit-project.org/index.php/Translations)
|
