Contribuer

Giretra est open source. N’importe qui peut participer à le construire. Pas besoin d’être développeur. Vous avez joué au jeu, repéré une faute de frappe, eu une idée de fonctionnalité, ou envie de traduire quelque chose dans votre langue ? Ça compte. Tout ça compte.

Il y a deux dépôts principaux sur GitHub :

• giretra/giretra est le moteur de jeu et play.giretra.com
• giretra/giretra.www est ce site web

Cette page explique comment participer, quel que soit votre profil.

Trouvez votre créneau

Il y a plein de manières de contribuer. En voici quelques-unes :

• Signaler un bug. Quelque chose a planté ou s’est comporté bizarrement ? Faites-le nous savoir.
• Proposer une idée. Vous avez une fonctionnalité en tête ? Une variante de règle ? Une amélioration d’interface ? Ouvrez une issue.
• Écrire ou corriger la doc. Clarifiez un passage confus, corrigez une faute, ajoutez des exemples.
• Traduire. Aidez à rendre Giretra accessible dans plus de langues.
• Designer. Améliorez les mises en page, les icônes, les visuels des cartes — tout ce qui est visuel.
• Tester. Essayez des choses, cherchez la petite bête, racontez-nous ce qui s’est passé.
• Relire du code. Parcourez les pull requests et partagez vos retours.
• Créer un bot. Écrivez un joueur IA et affrontez les autres.
• Répondre aux questions. Donnez un coup de main aux joueurs ou contributeurs qui bloquent.

Aucune de ces contributions ne nécessite de permission. Lancez-vous.

Pour commencer

Si vous voulez contribuer du code, de la doc ou des traductions, voici la marche à suivre :

1. Forkez le repo. Cliquez sur le bouton “Fork” sur GitHub. Vous obtenez votre propre copie.
2. Créez une branche. Donnez-lui un nom parlant, comme fix-scoring-typo ou add-malagasy-translation.
3. Faites vos modifications. Éditez ce que vous avez à éditer.
4. Pushez et ouvrez une pull request. Décrivez ce que vous avez changé et pourquoi.

C’est tout. Si vous n’avez jamais fait ça, GitHub propose de bons guides sur le fork et les pull requests. N’essayez pas de faire parfait du premier coup. On avancera ensemble.

Signaler des bugs

Vous avez trouvé quelque chose de cassé ? Ouvrez une issue. Incluez tout ce que vous pouvez :

• Ce que vous étiez en train de faire quand c’est arrivé
• Ce que vous vous attendiez à voir
• Ce qui s’est réellement passé
• Des captures d’écran si vous en avez

Ne vous prenez pas la tête avec la forme. Une description approximative vaut infiniment mieux que le silence. Même “la page des scores a l’air bizarre sur mobile” nous donne de quoi creuser.

Proposer des idées

Vous avez une idée ? Ouvrez une issue et décrivez-la. Pas besoin de suivre un template particulier. Formulez-la comme ça vous vient. Un paragraphe, une liste à puces, un dessin sur une serviette en photo. Peu importe, du moment que l’idée passe.

On préfère recevoir une idée encore brute plutôt que passer à côté d’une bonne idée parce que quelqu’un la trouvait pas assez aboutie.

Design et art visuel

C’est là qu’on a le plus besoin de renfort. Giretra est construit par des développeurs, et ça se voit. Design des cartes, illustrations, animations, palettes de couleurs, iconographie, finition des mises en page — tout ça gagnerait à passer entre les mains de quelqu’un qui s’y connaît vraiment. Si vous avez des compétences en design graphique, illustration, UI/UX, motion design, ou même simplement un œil affûté sur ce qui rend bien, on veut vous entendre.

Quelques domaines qui mériteraient de l’attention :

• Visuels des cartes. Les cartes actuelles sont fonctionnelles mais loin d’être belles. Des illustrations originales, de meilleures enseignes, des textures plus riches — tout ce qui peut donner du caractère au jeu de cartes.
• Finition UI. Espacement, typographie, cohérence des couleurs, mises en page responsives. Ces petits détails qui font la différence entre “ça marche” et “ça fait pro.”
• Branding et identité. Raffinement du logo, un système de couleurs cohérent, un langage visuel unifié sur le site et la plateforme.
• Animations et interactions. Distribution des cartes, résolution des plis, mise à jour des scores. Un soupçon de mouvement peut rendre l’expérience bien plus agréable.
• Illustrations. Des visuels d’accompagnement pour les pages de documentation, les états vides, les écrans d’erreur. Tout ce qui ajoute de la personnalité.

Vous n’avez pas besoin d’écrire du code. Vous pouvez :

• Joindre des maquettes ou captures d’écran à une issue
• Partager un lien Figma
• Décrire le changement avec des mots. “Les cartes devraient avoir plus de contraste” est un point de départ tout à fait valide

Si c’est votre domaine, n’hésitez pas. Un projet comme celui-ci se joue en grande partie sur son apparence et l’expérience qu’il procure — et c’est justement le côté le moins abouti pour l’instant.

Créer un bot

Giretra a un système de bots compétitif. Si vous voulez écrire un joueur IA qui se mesure aux autres, consultez le guide Créer votre Bot. Il couvre les templates, la mise en place et tout ce qu’il faut pour démarrer.

Code de conduite

Soyez sympa. Partez du principe que les intentions sont bonnes. Exprimez vos désaccords avec respect. C’est vraiment tout.

Toute personne qui contribue à Giretra — que ce soit pour sa première issue ou sa centième review — mérite de se sentir bienvenue. Si quelqu’un fait une erreur, aidez-le. Si vous n’êtes pas d’accord avec une approche, expliquez pourquoi. Restez constructif.

Un dernier mot

Pas besoin de demander la permission pour contribuer. Si vous voyez quelque chose qui pourrait être mieux, allez-y et améliorez-le. Chaque rapport de bug, chaque traduction, chaque ligne de code, chaque idée esquissée dans une issue — tout ça fait avancer le projet.

Commencez par ce qui vous parle. On trouvera la suite ensemble.