mirror of
https://github.com/FreshRSS/FreshRSS.git
synced 2026-03-10 10:28:47 -04:00
1acd3ab09b
* Use typographic quotes * A few fixes * Fix * Fix not saved * Implement feedback * Detail * Revert spoken English fixes Left for a future dedicated discussion * More reverts * Final reverts * Final minor
81 lines
4.0 KiB
Markdown
81 lines
4.0 KiB
Markdown
## 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/edge/docs) !
|