Comment contribuer

OpenDroneMap est dépendant des contributions de sa communauté. Vous pouvez contribuer de nombreuses façons, même si vous n’êtes pas programmeur.

Forum de la communauté

Si vous voulez vous impliquer, rencontrez un soucis ou voulez contacter quelqu’un, le forum <https://community.opendronemap.org/>`_  est l’endroit par lequel commencer. Vous pourriez y trouver vos questions déjà répondues, ou des astuces et ressources utiles. Vous pouvez aussi y partager vos données libres pour que les autres les utilise. C’est aussi le meilleur endroit pour y partager vos bugs ou partager vos suggestions d’amélioration avec les développeurs.

Signaler des bogues

Les bugs sont suivis en tant que Github Issues. Veuillez créer un problème dans le référentiel et le marquer avec la balise Bug.

Expliquez le problème et incluez des détails supplémentaires pour aider les responsables à reproduire le problème :

  • Utilisez un titre et un descriptif clair pour le problème afin d’identifier le problème.

  • Décrivez les étapes exactes qui reproduisent le problème avec autant de détails que possible. Par exemple, commencez par expliquer comment vous exécutez ODM (Docker, Vagrant, etc.), par ex. quelle commande exactement vous avez utilisée dans le terminal. Lorsque vous répertoriez les étapes, ne vous contentez pas de dire ce que vous avez fait, mais expliquez comment vous l’avez fait.

  • Fournissez des exemples spécifiques pour illustrer les étapes. Incluez des liens vers des fichiers ou des projets GitHub, ou des extraits de code à copier/coller, que vous utilisez dans ces exemples. Si vous fournissez des extraits de code dans le problème, utilisez Markdown code blocks.

  • Décrivez le comportement que vous avez observé après avoir suivi les étapes et indiquez quel est exactement le problème avec ce comportement.

  • Expliquez quel comportement vous vous attendiez à voir à la place et pourquoi.

  • Incluez des captures d’écran et des GIF animés qui vous montrent suivre les étapes décrites et démontrent clairement le problème. Vous pouvez utiliser cet outil pour enregistrer des GIF sur macOS et Windows, et cet outil ou celui-ci sur Linux.

  • Si le problème est lié aux performances, veuillez publier les spécifications de votre machine (machine hôte et machine invitée).

  • Si le problème n’a pas été déclenché par une action spécifique, décrivez ce que vous faisiez avant que le problème ne survienne et partagez plus d’informations en suivant les instructions ci-dessous.

Incluez des détails sur votre configuration et votre environnement :

  • Quelle version d’ODM utilisez-vous ? Une version stable ? un clone de maître ?

  • Quels sont le nom et la version du système d’exploitation que vous utilisez ?

  • Exécutez-vous ODM dans une machine virtuelle ou Docker ? Si oui, quel logiciel VM utilisez-vous et quels systèmes d’exploitation et versions sont utilisés pour l’hôte et l’invité ?

Modèle de soumission de rapports de bogues

[Short description of problem here]

**Reproduction Steps:**

1. [First Step]
2. [Second Step]
3. [Other Steps...]

**Expected behavior:**

[Describe expected behavior here]

**Observed behavior:**

[Describe observed behavior here]

**Screenshots and GIFs**

![Screenshots and GIFs which follow reproduction steps to demonstrate the problem](url)

**ODM version:** [Enter ODM version here]
**OS and version:** [Enter OS name and version here]

**Additional information:**

* Problem started happening recently, didn't happen in an older version of ODM: [Yes/No]
* Problem can be reliably reproduced, doesn't happen randomly: [Yes/No]
* Problem happens with all datasets and projects, not only some datasets or projects: [Yes/No]

Demande d’extraction

  • Incluez des captures d’écran et des GIF animés dans votre pull request dans la mesure du possible.

  • Suivez le guide de style Python PEP8.

  • Terminez les fichiers avec une nouvelle ligne.

  • Évitez le code dépendant de la plate-forme :

    • Utilisez require(“fs-plus”).getHomeDirectory() pour obtenir le répertoire personnel.

    • Utilisez path.join() pour concaténer les noms de fichiers.

    • Utilisez os.tmpdir() plutôt que /tmp lorsque vous devez référencer le répertoire temporaire.

  • Utilisation d’un retour simple lors du retour explicite à la fin d’une fonction.

    • Ne retourne pas null, retourne undefined, null ou undefined

Apprenez à éditer et aidez à améliorer cette page!