Skip to content

Latest commit

 

History

History
24 lines (21 loc) · 1.21 KB

CONTRIBUTING.md

File metadata and controls

24 lines (21 loc) · 1.21 KB

Contributing

You can contribute to this project by simply adding or fixing data in countries.json. Before sending your pull request you can optionally rebuild the files in the dist folder using the countries.php script.

Contributions rules

  1. contributions should contain top-level, static data
  2. restrain from sending too detailed, regional or changing countries data like financial or economic data (e.g. GDP, population, etc.)
  3. to ease the diffs, keep the indentation in the master source file (tabs not spaces), one line for short arrays
  4. accented characters must be encoded in unicode
  5. all strings must be encoded in UTF-8

Adding a build script

Countries data is made available in multiple formats (JSON, CSV, XML) that are generated by the countries.php script; you can either add a conversion format to it or write it in another language.

Generate dist files

To (re)generate the dist files, execute the following commands in the root directory:

composer install
php countries.php convert