# Checklist nouveau contributeur

Ce guide résume les étapes pour démarrer en tant que contributeur Mojaloop. Elles n’ont pas besoin d’être effectuées en une seule fois ; à la fin de cette checklist, vous devriez avoir acquis une bonne connaissance de Mojaloop et être prêt à contribuer à la communauté.

# 1. Outils et documentation

• Assurez-vous de disposer d’un compte GitHub, ou créez-en un ici : inscription (opens new window).

• Rejoignez le Slack via le lien d’invitation (opens new window), et ces canaux :

  • #announcements — Annonces des nouvelles releases et statut QA
  • #design-authority — Questions et discussions autour de la conception Mojaloop
  • #general — Discussion générale sur Mojaloop
  • #help-mojaloop — Aide à l’installation ou à l’exécution de Mojaloop
  • #ml-oss-bug-triage — Discussion et triage des nouveaux bugs et tickets

• Dites bonjour ! N’hésitez pas à vous présenter brièvement à la communauté sur le canal #general.

• Lisez le guide de workflow Git (opens new window) et assurez-vous d’être à l’aise avec Git.

  • Pour aller plus loin : Introduction au workflow GitHub (opens new window)

• Familiarisez-vous avec notre style de code : https://standardjs.com/

• Parcourez la documentation Mojaloop (opens new window) pour acquérir une compréhension de base du fonctionnement de la technologie.

• Suivez le guide des outils développeur (opens new window) pour installer et mettre en service les outils nécessaires sur votre environnement local.

• (Optionnel) Faire tourner Central-Ledger en local :

  • https://github.com/mojaloop/central-ledger/blob/master/Onboarding.md
  • https://github.com/mojaloop/ml-api-adapter/blob/master/Onboarding.md

• (Optionnel) Déployer un switch complet avec Kubernetes : https://mojaloop.io/documentation/deployment-guide/ (en local, le cluster Kubernetes nécessite en général 8 Go de RAM ou plus)

# 2. Trouver un ticket

• Parcourez la liste good-first-issue (opens new window) sur mojaloop/project (opens new window) pour trouver un bon ticket pour commencer. Vous pouvez aussi contacter la communauté sur Slack sur #general pour demander de l’aide à en trouver un.

• Laissez un commentaire sur le ticket pour demander à ce qu’il vous soit assigné — cela permet d’éviter le travail en double. Comme toujours, n’hésitez pas à nous contacter sur Slack si vous avez des questions ou des préoccupations.

• Forkez les dépôts concernés, clonez et créez une branche pour le ticket.

  • Voir le guide utilisateur Git (opens new window) si besoin.

# 3. Ouvrir votre première PR

À faire une fois ajouté à l’organisation GitHub Mojaloop. Sans accès, écrivez sur #general ou #help-mojaloop.

• Inscrivez-vous sur Zenhub (opens new window), connectez-le à l’organisation Mojaloop et cherchez l’espace de travail project.

• Installez l’extension navigateur Zenhub (opens new window) pour Chrome ou Firefox et parcourez le tableau Kanban du projet Mojaloop (opens new window).

• Lorsque votre branche est prête pour revue, ouvrez une pull request depuis votre dépôt vers le projet mojaloop.

  Note : si les pipelines CI/CD ne se lancent pas, votre compte GitHub n’est peut-être pas ajouté au dépôt Mojaloop.

• Vérifiez :

  • Une bonne description de la fonctionnalité ou du correctif que vous avez implémenté
  • La PR assignée à vous-même
  • Au moins deux reviewers assignés. GitHub en suggère souvent ; sinon, n’hésitez pas à contacter l’auteur du ticket.

• (Optionnel) Partagez le lien de votre PR sur #ml-oss-devs sur Slack pour que tout le monde puisse partager le plaisir.

# 4. Signer la CLA

Après votre première PR, la CI vous demandera de signer la CLA. Pour plus d’informations sur ce qu’est la CLA et la procédure pour la signer, consultez Signer la CLA.