Résoudre un Challenge

Dans ce guide, vous apprendrez comment résoudre un challenge et soumettre une réponse sur le répertoire principal de GitHub.

Introduction

Ce répertoire utilise Nx. Nx est un monorépo qui vous permet de stocker plusieurs applications à l’intérieur du même espace de travail. Chaque challenge est une application distincte. Si vous ouvrez le répertoire apps, vous trouverez plusieurs dossiers, chacun lié à un challenge spécifique. Chaque dossier représente une application autonome complète Nx. Pour exécuter et démarrer l’une d’entre elles, ouvrez votre terminal et exécutez :

npx nx serve <NOM_APPLICATION>

Note

Si vous n’êtes pas sûr de votre NOM_APPLICATION, ouvrez le fichier README.md. La commande serve y est écrite, avec un lien vers la documentation du challenge.

Note

Si vous installez nx globalement sur votre ordinateur, vous éviterez de préfixer chaque commande par npx.

Pour installer nx globalement, exécutez

npm i -g nx

Créer une Branche Git

Avant de commencer à résoudre un challenge, créez une branche git pour y ajouter vos modifications.

git checkout -b <BRANCH_NAME>

Résoudre un Challenge

Suivez les instructions décrites sur chaque Challenge pour le résoudre.

Commitez et Pousser votre Travail

La dernière étape consiste à valider votre travail en suivant les Conventional Guidelines.

Enfin, poussez votre travail vers le répertoire distant avec la commande suivante

    git push --set-upstream origin <BRANCH_NAME>

Pas besoin de retenir la commande par coeur

Vous n’avez pas besoin de mémoriser précisément la commande. Il vous suffit de vous rappeler git push et si c’est la première fois que vous poussez cette branche, git vous fournira la commande complète.

Soumettre votre Travail sur le répertoire Principal

Maintenant, tout votre travail se trouve dans votre instance locale du dépôt de Angular Challenges.

La prochaine étape est de vous rendre sur la page principale de Angular Challenges et de créer une nouvelle Pull Request.

GitHub devrait afficher en en-tête une notification pour vous aider à créer la pull request.

Si ce n’est pas le cas, vous avez soit mal effectué l’une des étapes précédentes, soit vous pouvez vous rendre sur l’onglet Pull Request et cliquer sur le bouton New pull request.

Une fois que vous avez choisi les deux branches à comparer, vous devriez arriver sur la page suivante :

Dans la section du titre, commencez par Réponse : suivi de votre numéro de challenge. Ensuite, vous êtes libre d’ajouter tout ce que vous souhaitez.

Danger

C’est très important. Cela permet aux autres de savoir quel challenge vous tentez de résoudre.

Dans la section de description, vous pouvez ajouter des questions, des problèmes rencontrés ou tout autre contenu que vous souhaitez partager. Vous pouvez laisser vide si vous n’avez rien à dire.

Vous pouvez maintenant cliquer sur Créer pull request.

Avoir un Retour

Pour continuer à donner des retours de qualités, sponsorise le project sur Github:

• $5 pour une review
• $25 pour des reviews a vie
• Créez un challenge/Contribuez pour des reviews à vie

Note

Tout le monde peut commenter ou lire les Pull Requests des autres participants.

Champion OSS

🔥 Une fois que vous avez terminé ce tutoriel, vous êtes prêt à contribuer à n’importe quel répertoire public GitHub et à soumettre une PR. C’est aussi simple que ça. 🔥