diff --git a/docs/src/content/docs/fr/guides/checkout-answer.md b/docs/src/content/docs/fr/guides/checkout-answer.md new file mode 100644 index 0000000..9a16f2a --- /dev/null +++ b/docs/src/content/docs/fr/guides/checkout-answer.md @@ -0,0 +1,59 @@ +--- +title: Consulter la réponse de quelqu'un d'autre +description: Guide pour consulter la réponse de quelqu'un d'autre. +contributors: + - alannelucq +sidebar: + order: 3 +--- + +Toutes les réponses aux Challenges Angular seront présentées sous la forme d'une pull request (PR). Pour les consulter +et +les suivre, naviguez dans la page Files Changes sur GitHub. Cependant, comprendre et suivre ce processus peut ne pas +être simple si vous n'êtes pas familier avec l'interface. Dans de nombreux cas, vous préférerez peut-être vous mettre +sur la branche et examiner la réponse dans votre IDE préféré. + +## Installer la CLI de GitHub + +Suivez les instructions pour votre système d'exploitation [ici](https://github.com/cli/cli#installation). + +## Consulter la PR de quelqu'un d'autre en local + +### Synchronisez votre dépôt + +Tout d'abord, vous devez synchroniser votre fork pour vous assurer qu'il soit à jour avec le dépôt forké. + +Cela peut être réalisé en cliquant sur le bouton Sync fork sur la page principale de votre fork. + +![Sync project header](../../../../assets/fork-sync.png) + +L'image ci-dessus montre que ma branche a 8 commits de retard par rapport à la branche principale, et je dois la +synchroniser pour qu'elle soit à jour. + +![Sync project update modal](../../../../assets/sync-fork-update.png) + +### Consulter la PR en local + +Recherchez la PR que vous souhaitez consulter en local et récupérez son ID. Vous le trouverez dans le titre de la +PR (comme illustré ci-dessous). + +![PR header](../../../../assets/PR-header.png) + +Ensuite, ouvrez n'importe quel terminal dans le répertoire de votre projet et exécutez la commande suivante : + +```bash +gh pr checkout +``` + +Si vous ne vous souvenez pas de la commande, cliquez sur le bouton Code sur le côté droit de l'en-tête, et vous pourrez +facilement la copier/coller. + +![PR code modal](../../../../assets/PR-code-btn-modal.png) + +:::note +Si la commande ne fonctionne pas ou échoue, l'interface CLI de GitHub vous guidera à travers le processus. +::: + +🔥 Vous pouvez maintenant consulter la réponse en local et la lancer pour la tester. 🔥 + + diff --git a/docs/src/content/docs/fr/guides/contribute.md b/docs/src/content/docs/fr/guides/contribute.md new file mode 100644 index 0000000..69e8d4a --- /dev/null +++ b/docs/src/content/docs/fr/guides/contribute.md @@ -0,0 +1,24 @@ +--- +title: Comment contribuer ? +description: Guide pour savoir comment contribuer à ce projet. +contributors: + - alannelucq +sidebar: + order: 4 +--- + +Vous pouvez contribuer à ce projet de plusieurs manières : + +🔥 Créer un nouveau challenge en suivant ces [instructions](/guides/create-challenge). + +🔥 Répondre aux challenges et soumettez les résultats (guide [ici](/guides/resolve-challenge)). + +🔥 Donner des retours bienveillants et constructifs sur les solutions des autres. + +🔥 Corriger les fautes de frappe dans la documentation. + +🔥 Aider à la traduction de la documentation. + +🔥 Créer une issue pour suggérer de nouvelles idées de challenges ou signaler un bug. + +🔥 Sponsoriser le projet [ici](https://github.com/sponsors/tomalaforge). diff --git a/docs/src/content/docs/fr/guides/create-challenge.md b/docs/src/content/docs/fr/guides/create-challenge.md new file mode 100644 index 0000000..a197db0 --- /dev/null +++ b/docs/src/content/docs/fr/guides/create-challenge.md @@ -0,0 +1,68 @@ +--- +title: Créer un challenge +description: Guide sur comment créer un challenge +contributors: + - alannelucq +sidebar: + order: 5 +--- + +Vous avez une idée à partager, un bug intéressant avec lequel vous luttez dans l'un de vos projets privés ou +secondaires, ou une astuce Angular que vous avez découverte ? Toutes ces situations sont un bon point de départ pour +créer un challenge et partager votre solution avec les autres. + +Comment commencer à créer ces challenges ? + +## Configuration de base + +Pour simplifier le processus, j'ai créé un générateur Nx qui configurera tout le code de base pour vous. Le moyen le +plus +simple de l'exécuter est d'utiliser la console Nx : allez dans Nx Console > generate > @angular-challenges/cli - +challenge. + +Vous pouvez également utiliser [l'extension Nx Console](https://nx.dev/getting-started/editor-setup) de votre IDE pour +générer les fichiers. + +### Paramètres + +#### Paramètres obligatoires + +- title: Le titre que vous souhaitez donner à votre challenge. + :::note + Le titre doit comporter un maximum de 25 caractères. + ::: + +- challengeDifficulty: La difficulté estimée de votre challenge. Il y a trois niveaux de difficulté : 🟢 facile / + 🟠 moyen / 🔴 difficile +- name: Le nom de l'application Nx. + :::note + Il doit être écrit en **kebab-case**. + ::: +- docRepository: La catégorie de votre challenge : Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript, ou + Forms. + +#### Paramètres optionnels + +- directory: Si vous souhaitez que votre application soit située dans un dossier spécifique à l'intérieur + de `apps`. +- addTest: Si vous souhaitez ajouter une configuration de test. + +### Qu'est-ce qui est créé ? + +- Le générateur créera tous les fichiers nécessaires pour avoir une nouvelle application fonctionnelle. Tous ces + fichiers seront créés dans apps/${directory}/${name}. +- Un fichier Markdown avec une configuration minimale sera créé dans docs/src/content/docs/challenges/${docRepository}. + +## Création d'un challenge + +La seule chose qu'il vous reste à faire est de créer votre challenge. 🚀 + +:::danger +N'oubliez pas de mettre à jour la documentation pour présenter votre challenge et fournir vos instructions. +::: + +À vous de jouer !!! 💪 + +## Soumission d'une solution + +Après environ une semaine, fournissez une pull request de la solution de votre challenge. diff --git a/docs/src/content/docs/fr/guides/faq.md b/docs/src/content/docs/fr/guides/faq.md new file mode 100644 index 0000000..abbba29 --- /dev/null +++ b/docs/src/content/docs/fr/guides/faq.md @@ -0,0 +1,24 @@ +--- +title: FAQ +description: Foire Aux Questions +contributors: + - alannelucq +sidebar: + order: 7 +--- + +
+ + Pourquoi mon application ne démarre-t-elle pas, ou pourquoi est-ce que je rencontre des erreurs dans mon terminal lorsque je lance `nx serve` ? + + +La plupart du temps, ce problème survient parce que vos node_modules sont obsolètes et que vous devez les mettre à jour +en exécutant `npm ci`. + +Si le processus d'installation échoue, vous pouvez résoudre ce problème en supprimant votre dossier node_modules en +utilisant la commande `rm -rf node_modules` ou `npx npkill`, puis en relançant `npm ci`. + +Si le problème persiste, veuillez signaler le +problème [ici](https://github.com/tomalaforge/angular-challenges/issues/new). + +
diff --git a/docs/src/content/docs/fr/guides/rebase.md b/docs/src/content/docs/fr/guides/rebase.md new file mode 100644 index 0000000..bf50ebb --- /dev/null +++ b/docs/src/content/docs/fr/guides/rebase.md @@ -0,0 +1,63 @@ +--- +title: Rebase votre branche +description: Guide pour faire un rebase de sa branche et récupérer les derniers changements. +contributors: + - alannelucq +sidebar: + order: 6 +--- + +Parfois, des modifications peuvent être ajoutées au projet. Je vais essayer de faire des changements qui ne cassent +rien, mais parfois, c'est inévitable. + +La plupart du temps, vous n'aurez pas besoin de rebaser votre solution, mais voici un guide pour vous aider à savoir +comment le faire. + +:::note +Ce guide est applicable à tout projet Open Source. +::: + +## Étapes pour rebaser votre branche + +### Synchronisez votre dépôt + +Tout d'abord, vous devez synchroniser votre fork pour vous assurer qu'il est à jour avec le dépôt forké. + +Vous pouvez le faire en cliquant sur le bouton Sync fork sur la page principale de votre fork. + +![Sync project header](../../../../assets/fork-sync.png) + +L'image ci-dessus montre que ma branche a 8 commits de retard par rapport à la branche principale et que je dois la +synchroniser pour qu'elle soit à jour. + +![Sync project update modal](../../../../assets/sync-fork-update.png) + +### Ouvrez un terminal + +Ouvrez le terminal de votre choix, soit celui de votre IDE préféré, soit une instance autonome. + +### Git + +Exécutez les commandes suivantes pour rebaser votre branche locale : + +- git checkout main +- git pull +- git checkout [votre branche] +- git rebase main +- Résolvez les conflits + +À cette étape, le rebase peut s'arrêter parce que votre branche locale a des fichiers en conflit avec la branche +principale. Corrigez-les. + +Une fois que c'est fait : + +- git add . +- git rebase --continue + +Si votre branche n'a pas de conflit, un message de succès sera affiché. + +### Envoyez votre travail vers la branche distante + +Enfin, envoyez votre travail vers GitHub : + +- git push -f