Contributing Guidelines#

First off, thanks for considering to contribute to this project!

These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.

GPF pratiques partagées#

Merci de tenir compte de la documentation de l’Usine Logicielle sur les pratiques Git partagées : https://geoplateforme.pages.gpf-tech.ign.fr/documentation/developer/git_guidelines/.

We use git hooks through pre-commit to enforce and automatically check some “rules”. Please install it before to push any commit.

See the relevant configuration file: .pre-commit-config.yaml.

Make sure your code roughly follows PEP-8 and keeps things consistent with the rest of the code:

docstrings: google-style is used to write technical documentation.
formatting: black is used to automatically format the code without debate.
sorted imports: isort is used to sort imports
static analysis: flake8 is used to catch some dizziness and keep the source code healthy.

The pattern is: {category}/{slugified-description}. Where:

category is the type of work. Can be: feature, bug, tooling, refactor, test, chore, release, hotfix, docs, ci, deploy or release-candidate.
slugified-description is the description of the work, slugified.

Example: feature/authentication-logic