X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/88fab4400648bec915ba4214434e1580dd9d9678..1bee151fe3ccfd21df1d809392d6eb52ce7925cb:/CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 89b76e3b..e031cd91 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,41 +7,6 @@ Please always open a separate issue for each problem. In particular, do not add your bugs to closed issues. They may looks similar to you but often are completely different from the maintainer's point of view. -### When Reporting Bad Search Results... - -Please make sure to add the following information: - - * the URL of the query that produces the bad result - * the result you are getting - * the expected result, preferably a link to the OSM object you want to find, - otherwise an address that is as precise as possible - -To get the link to the OSM object, you can try the following: - - * go to https://openstreetmap.org - * zoom to the area of the map where you expect the result and - zoom in as much as possible - * click on the question mark on the right side of the map, - then with the queston cursor on the map where your object is located - * find the object of interest in the list that appears on the left side - * click on the object and report the URL back that the browser shows - -### When Reporting Bugs... - -Please add the following information to your issue: - - * hardware configuration: RAM size, CPUs, kind and size of disks - * Operating system (also mention if you are running on a cloud service) - * Postgres and Postgis version - * list of settings you changed in your Postgres configuration - * Nominatim version (release version or, - if you run from the git repo, the output of `git rev-parse HEAD`) - * (if applicable) exact command line of the command that was causing the issue - -Bug reports that do not include extensive information about your system, -about the problem and about what you have been trying to debug the problem -will be closed. - ## Workflow for Pull Requests We love to get pull requests from you. We operate the "Fork & Pull" model @@ -71,7 +36,7 @@ Nominatim historically hasn't followed a particular coding style but we are in process of consolidating the style. The following rules apply: * Python code uses the official Python style - * indention + * indentation * SQL use 2 spaces * all other file types use 4 spaces * [BSD style](https://en.wikipedia.org/wiki/Indent_style#Allman_style) for braces @@ -84,22 +49,18 @@ are in process of consolidating the style. The following rules apply: * for PHP variables use CamelCase with a prefixing letter indicating the type (i - integer, f - float, a - array, s - string, o - object) -The coding style is enforced with PHPCS and can be tested with: +The coding style is enforced with PHPCS and pylint. It can be tested with: ``` - phpcs --report-width=120 --colors . +phpcs --report-width=120 --colors . +pylint3 --extension-pkg-whitelist=osmium nominatim ``` ## Testing -Before submitting a pull request make sure that the following tests pass: - -``` - cd test/bdd - behave -DBUILDDIR= db osm2pgsql -``` +Before submitting a pull request make sure that the tests pass: ``` - cd test/php - phpunit ./ + cd build + make test ```