docs(fr): add french translation for pages in guides section (#936)

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 <ID>
+```
+
+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. 🔥
+
+<!-- gh repo set-default -->

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).

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 <b>Nx Console > generate > @angular-challenges/cli -
+challenge</b>.
+
+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
+
+- <b>title</b>: Le titre que vous souhaitez donner à votre challenge.
+  :::note
+  Le titre doit comporter un maximum de 25 caractères.
+  :::
+
+- <b>challengeDifficulty</b>: La difficulté estimée de votre challenge. Il y a trois niveaux de difficulté : 🟢 facile /
+  🟠 moyen / 🔴 difficile
+- <b>name</b>: Le nom de l'application Nx.
+  :::note
+  Il doit être écrit en **kebab-case**.
+  :::
+- <b>docRepository</b>: La catégorie de votre challenge : Nx, Angular, Angular Performance, Rxjs, NgRx, Typescript, ou
+  Forms.
+
+#### Paramètres optionnels
+
+- <b>directory</b>: Si vous souhaitez que votre application soit située dans un dossier spécifique à l'intérieur
+  de `apps`.
+- <b>addTest</b>: 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.

docs/src/content/docs/fr/guides/faq.md

@@ -0,0 +1,24 @@
+---
+title: FAQ
+description: Foire Aux Questions
+contributors:
+  - alannelucq
+sidebar:
+  order: 7
+---
+
+<details>
+  <summary>
+    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` ?
+  </summary>
+
+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).
+
+</details>

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