---
sidebar_position: 1
---

# Contribuer à francisca

Merci de votre intérêt pour contribuer au projet francisca ! Cette page décrit les façons dont vous pouvez aider, nos
politiques de contribution, et comment démarrer avec votre première Issue ou Pull Request (PR).

Même si vous ne pouvez pas contribuer de code, vous pouvez toujours aider francisca ! Les principales façons de
contribuer sont de tester, signaler des problèmes, et améliorer la documentation. Le code, la documentation et d'autres
contributions sont tous les bienvenus—consultez les sections ci-dessous pour plus de détails.

---

## Signaler des problèmes

Nous utilisons GitHub Issues pour suivre les bugs, améliorations et demandes de fonctionnalités.

- Veuillez consulter la [documentation des issues](/.github/ISSUE_TEMPLATE/issue_report.yml) pour des conseils sur la
  soumission d'issues claires et utiles.
- Avant d'ouvrir une nouvelle issue, cherchez dans les [issues existantes](https://github.com/UwUDev/francisca/issues)
  pour éviter les doublons.
- Pour les questions d'utilisation ou le dépannage, veuillez utiliser
  les [Discussions](https://github.com/UwUDev/francisca/discussions).

---

## Développer du code

francisca est écrit en Rust. Si vous avez de l'expérience avec Rust, nous accueillons vos contributions !

- Consultez notre [guide de développement](/docs/source-guide-fr.md) pour savoir comment configurer votre environnement
  de développement, compiler francisca depuis les sources et soumettre des PRs.
- Nous suivons un workflow "fork and PR". Si c'est nouveau pour vous, consultez
  le [guide de fork de GitHub](https://docs.github.com/fr/get-started/quickstart/fork-a-repo).

---

## Améliorer la documentation

La documentation est extrêmement précieuse ! Toute la documentation est écrite en Markdown et se trouve dans le
dossier [`/docs`](/docs) du dépôt.

- Pour suggérer des changements, ouvrez une Pull Request avec vos améliorations.
- Pour les changements majeurs de documentation, veuillez d'abord ouvrir une issue ou une discussion.

---

## Tester

Tester est l'une des façons les plus faciles et les plus précieuses de contribuer.

- Utilisez simplement francisca, et si vous trouvez des bugs ou des comportements
  inattendus, [ouvrez une issue](https://github.com/UwUDev/francisca/issues).
- Si vous avez des suggestions d'améliorations ou de nouvelles fonctionnalités, vous pouvez aussi les soumettre sous
  forme d'issues.

---

## Compiler et exécuter francisca

- Pour compiler francisca depuis les sources, suivez le [guide de compilation manuel](/docs/source-guide-fr.md).
- Pour les utilisateurs Docker, consultez le [guide de déploiement Docker](/docs/docker-guide-fr.md) pour les
  instructions sur l'utilisation de l'image officielle ou la construction de votre propre image.

---

Merci d'aider à améliorer francisca ! Chaque contribution—grande ou petite—fait une différence.