4.1 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Résoudre un Challenge | Guide pour 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>
:::tip[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.
Je la lirai et commenterai quand j'aurai du temps libre.
Ne vous inquiétez pas si votre réponse n'est pas examinée immédiatement. Je le fais gratuitement et pendant mon temps libre. Si vous souhaitez me soutenir, vous pouvez le faire en me sponsorisant sur GitHub. Cela validera que mon travail vous aide, vous ou votre équipe.
:::note Tout le monde peut commenter ou lire les Pull Requests des autres participants. :::
:::tip[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. 🔥 :::