mirror of
https://github.com/FreshRSS/FreshRSS.git
synced 2026-02-13 06:51:20 -05:00
5beebfcd45
Not stable yet, but initial structure https://agents.md https://agentskills.io/specification https://code.visualstudio.com/docs/copilot/customization/custom-instructions https://code.visualstudio.com/docs/copilot/customization/agent-skills
77 lines
3.8 KiB
Markdown
77 lines
3.8 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](https://github.com/FreshRSS/FreshRSS/discussions/categories/q-a).
|
||
|
||
## 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, PostgreSQL, MariaDB, MySQL ? 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).
|
||
|
||
> ℹ Voir [`AGENTS.md`](https://github.com/FreshRSS/FreshRSS/blob/edge/AGENTS.md) pour les conventions de code (à la fois pour les humains et agents IA).
|
||
|
||
**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) !
|