## Rejoignez-nous sur les listes de mailing S'il vous manque des informations, n'hésitez pas à fouiller un peu la documentation ou venir nous poser directement vos questions sur [la mailing list des développeurs](https://freshrss.org/mailman/listinfo/dev). * Le premier mailing est destiné à l'information générique, il doit être adapté aux utilisateurs. [Rejoignez mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing). * Le deuxième mailing s'adresse principalement aux développeurs. [Rejoignez dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev) ## Signaler un bug Avez-vous trouvé un bogue ? Ne paniquez pas, voici quelques étapes pour le signaler facilement : 1. Cherche sur [le bug tracker](https://github.com/FreshRSS/FreshRSS/issues) (n'oubliez pas d'utiliser la barre de recherche). 2. Si vous constatez un bogue similaire, n'hésitez pas à poster un commentaire pour ajouter de l'importance au ticket correspondant. 3. Si vous ne l'avez pas trouvé, [ouvrez un nouveau ticket](https://github.com/FreshRSS/FreshRSS/issues/new). Si vous devez créer un nouveau ticket, essayez de garder les conseils suivants : * Donnez un titre explicite au ticket pour le retrouver plus facilement plus tard. * Soyez aussi exhaustif que possible dans la description : qu'avez-vous fait ? Quel est le bogue ? Quelles sont les étapes pour reproduire le bogue ? Nous avons aussi besoin de quelques informations : * Votre version de FreshRSS (sur la page A propos) ou le fichier `constants.php`) * Votre configuration de serveur : type d'hébergement, version PHP * Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle version ? * Si possible, les logs associés (logs PHP et logs FreshRSS sous `data/users/your_user/log.txt`) ## Corriger un bogue Voulez-vous corriger un bogue ? Pour maintenir une grande coordination entre les collaborateurs, vous devrez suivre ces indications : 1. Assurez-vous que le bogue est associé à un ticket et indiquez que vous allez travailler sur le bogue. 2. [Fork du répertoire de projet](https://help.github.com/articles/fork-a-repo/). 3. [Créez une nouvelle branche](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/). Le nom de la branche doit être clair, et idéalement préfixé par l'identifiant du ticket correspondant. Par exemple, `783-contributing-file` pour réparer [ticket #783](https://github.com/FreshRSS/FreshRSS/issues/783). 4. Ajoutez vos modifications à votre fork et [ouvrez une demande de pull request](https://help.github.com/articles/using-pull-requests/). Si vous devez écrire du code, veuillez suivre [nos recommandations de style de codage](developers/01_First_steps.md). **Conseil : **si vous cherchez des bugs faciles à corriger, jetez un coup d'oeil à la vignette "[good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)". ## Soumettre une idée Vous avez de bonnes idées, oui ! Ne soyez pas timide et ouvrez [un nouveau ticket](https://github.com/FreshRSS/FreshRSS/issues/new) sur notre tracker bogue pour nous demander si nous pouvons le mettre en œuvre. Les plus grandes idées viennent souvent des suggestions les plus timides ! Si votre idée est bonne, nous y jetterons un coup d'oeil. ## Contribuer à l'internationalisation (i18n) Si vous voulez améliorer l'internationalisation, ouvrez d'abord un nouveau ticket et suivez les conseils de la section *Fixer un bogue*. Les traductions sont disponibles dans les sous-répertoires de `./app/i18n/`. Nous travaillons sur une meilleure façon de gérer l'internationalisation mais n'hésitez pas à nous suggérer des idées ! ## Contribuer à la documentation Il ne vous aura pas échappé que la documentation est encore un peu vide… il y a énormément de choses à faire ! Si vous souhaitez aider à écrire quelques pages, rendez-vous dans les principaux dépôts[fichier docs](https://github.com/FreshRSS/FreshRSS/tree/master/docs) !