finish The Handbook page

mk360 · mk360 · commit 28915e67c1f5 · 2022-10-06T23:06:07.000+02:00
diff --git a/docs/documentation/fr/get-started/TS for JS Programmers.md b/docs/documentation/fr/get-started/TS for JS Programmers.md
@@ -1,6 +1,6 @@
 ---
-title: TypeScript pour les développeurs JavaScript
-short: TypeScript pour les développeurs JS
+title: TypeScript pour les Programmeurs JavaScript
+short: TypeScript pour les Programmeurs JS
 layout: docs
 permalink: /fr/docs/handbook/typescript-in-5-minutes.html
 oneline: Apprenez comment TypeScript étend JavaScript
diff --git a/docs/documentation/fr/get-started/TS for OOPers.md b/docs/documentation/fr/get-started/TS for OOPers.md
@@ -1,6 +1,6 @@
 ---
-title: TypeScript pour les Développeurs Java/C#
-short: TS pour les Développeurs Java/C#
+title: TypeScript pour les Programmeurs Java/C#
+short: TS pour les Programmeurs Java/C#
 layout: docs
 permalink: /fr/docs/handbook/typescript-in-5-minutes-oop.html
 oneline: Apprenez TypeScript si vous avez de l'expérience avec les langages orientés objet
diff --git a/docs/documentation/fr/handbook-v2/The Handbook.md b/docs/documentation/fr/handbook-v2/The Handbook.md
@@ -8,52 +8,52 @@ handbook: "true"
 
 ## À propos de ce manuel
 
-20 ans après sa conception, le JavaScript est désormais l'un des langages multi-plateformes des plus répandus. Starting as a small scripting language for adding trivial interactivity to webpages, JavaScript has grown to be a language of choice for both frontend and backend applications of every size. While the size, scope, and complexity of programs written in JavaScript has grown exponentially, the ability of the JavaScript language to express the relationships between different units of code has not. Combined with JavaScript's rather peculiar runtime semantics, this mismatch between language and program complexity has made JavaScript development a difficult task to manage at scale.
+20 ans après sa conception, le JavaScript est désormais l'un des langages multi-plateformes des plus répandus. Étant, à ses débuts, un langage de scripting pour une interactivité minimale avec les pages web, le JavaScript a grandi bien au-delà, et est devenu un langage de choix pour toute application côté client et serveur. L'étendue, la taille, et la portée des applications JavaScript ont grandi exponentiellement, mais la capacité du langage à exprimer les relations entre les différentes unités de code n'a pas suivi. S'ajoute à cela la sémantique particulière à l'exécution, pour mener à une différence de complexité entre langage et programme, rendant le développement JavaScript difficile à moyenne et grande échelle.
 
-The most common kinds of errors that programmers write can be described as type errors: a certain kind of value was used where a different kind of value was expected. This could be due to simple typos, a failure to understand the API surface of a library, incorrect assumptions about runtime behavior, or other errors. The goal of TypeScript is to be a static typechecker for JavaScript programs - in other words, a tool that runs before your code runs (static) and ensures that the types of the program are correct (typechecked).
+Les erreurs les plus fréquentes que peuvent rencontrer les programmeurs sont des erreurs de types : un certain genre de valeur a été utilisé là où un genre différent était attendu. Les raisons peuvent être de simples fautes d'orthographe, une incompréhension de l'API de la librairie, des suppositions incorrectes sur le comportement d'une méthode à l'exécution, et bien d'autres raisons encore. Le but de TypeScript est d'être un vérificateur statique de types pour votre code - en d'autres termes, un outil qui se lance avant votre code (statique) et qui s'assure que les types de votre programme sont cohérents et corrects.
 
-If you are coming to TypeScript without a JavaScript background, with the intention of TypeScript being your first language, we recommend you first start reading the documentation on either the [Microsoft Learn JavaScript tutorial](https://docs.microsoft.com/javascript/) or read [JavaScript at the Mozilla Web Docs](https://developer.mozilla.org/docs/Web/JavaScript/Guide).
-If you have experience in other languages, you should be able to pick up JavaScript syntax quite quickly by reading the handbook.
+Si vous souhaitez apprendre TypeScript sans avoir de vécu avec JavaScript, si TypeScript est votre tout premier langage, il est recommandé de commencer par la documentation du [tutoriel Microsoft pour apprendre le JavaScript](https://developer.microsoft.com/fr-fr/javascript/) ou la [guide Mozilla Developer Network de JavaScript](https://developer.mozilla.org/fr/docs/Web/JavaScript/Guide).
+Si vous avez de l'expérience avec d'autres langages, vous serez probablement capable d'apprendre TypeScript en lisant le manuel.
 
-## How is this Handbook Structured
+## Structure du Manuel
 
-The handbook is split into two sections:
+Ce manuel est séparé en deux sections :
 
-- **The Handbook**
+- **Le Manuel**
 
-  The TypeScript Handbook is intended to be a comprehensive document that explains TypeScript to everyday programmers. You can read the handbook by going from top to bottom in the left-hand navigation.
+  Le Manuel TypeScript a pour intention d'être un document qui explique les concepts de TypeScript. Vous pouvez lire le manuel en suivant les chapitres de haut en bas dans la navigation à gauche.
 
-  You should expect each chapter or page to provide you with a strong understanding of the given concepts. The TypeScript Handbook is not a complete language specification, but it is intended to be a comprehensive guide to all of the language's features and behaviors.
+  Chaque chapitre ou page doit vous fournir une importante compréhension des concepts qu'il ou elle mentionne. Le Manuel n'a pas pour but de jouer le rôle de document de spécification, mais il est prévu pour être un guide détaillé autour de toutes les fonctionnalités et comportements du langage.
 
-  A reader who completes the walkthrough should be able to:
+  Un lecteur pourra, dès lors qu'il lit le manuel :
 
-  - Read and understand commonly-used TypeScript syntax and patterns
-  - Explain the effects of important compiler options
-  - Correctly predict type system behavior in most cases
+  - Lire et écrire de la syntaxe commune en TypeScript
+  - Expliquer l'effet des options importantes de compilateur
+  - Prédire correctement les effets du système de types dans la plupart des cas
 
-  In the interests of clarity and brevity, the main content of the Handbook will not explore every edge case or minutiae of the features being covered. You can find more details on particular concepts in the reference articles.
+  Pour rester dans la concision et la clarté, le contenu principal du Manuel ne va pas couvrir tous les cas d'usages marginaux et détaillés des fonctionnalités couvertes. Vous pourrez trouver plus de détails sur certains concepts dans les articles de références.
 
-- **Reference Files**
+- **Fichiers de références**
 
-  The reference section below the handbook in the navigation is built to provide a richer understanding of how a particular part of TypeScript works. You can read it top-to-bottom, but each section aims to provide a deeper explanation of a single concept - meaning there is no aim for continuity.
+  La section de Références qui suit le Manuel est conçue pour fournir une compréhension plus complète sur une partie particulière de TypeScript. Vous pouvez la lire de haut en bas, mais chaque section a pour but de développer vos connaissances sur un sujet particulier - ces sections ne sont donc pas censées suivre une certaine continuité.
 
-### Non-Goals
+### Ce que le Manuel n'est pas
 
-The Handbook is also intended to be a concise document that can be comfortably read in a few hours. Certain topics won't be covered in order to keep things short.
+Le Manuel doit être un document qui doit être lu en quelques heures maximum. Certains sujets ne vont pas être couverts, pour rester dans la brièveté.
 
-Specifically, the Handbook does not fully introduce core JavaScript basics like functions, classes, and closures. Where appropriate, we'll include links to background reading that you can use to read up on those concepts.
+Plus précisément, ce Manuel n'introduit pas de concepts basiques en JavaScript, comme les fonctions, classes, et fermetures (_closures_). Un lien de lecture de fond sera inclus si nécessaire, pour pouvoir vous familiariser avec ces concepts.
 
-The Handbook also isn't intended to be a replacement for a language specification. In some cases, edge cases or formal descriptions of behavior will be skipped in favor of high-level, easier-to-understand explanations. Instead, there are separate reference pages that more precisely and formally describe many aspects of TypeScript's behavior. The reference pages are not intended for readers unfamiliar with TypeScript, so they may use advanced terminology or reference topics you haven't read about yet.
+Le Manuel n'est pas un remplacement pour la spécification du langage. Les cas marginaux et les descriptions formelles de comportement vont être mis de côté, à la faveur d'explications plus simples et plus compréhensibles. Par contre, des pages de référence sont prévues à cet effet. Ces pages de référence ne sont pas prévues pour les lecteurs qui ne sont pas familiers avec TypeScript, donc il se peut qu'elles couvrent des sujets que vous n'avez pas encore lus ou qu'elles utilisent de la terminologie avancée.
 
-Finally, the Handbook won't cover how TypeScript interacts with other tools, except where necessary. Topics like how to configure TypeScript with webpack, rollup, parcel, react, babel, closure, lerna, rush, bazel, preact, vue, angular, svelte, jquery, yarn, or npm are out of scope - you can find these resources elsewhere on the web.
+Enfin, le Manuel ne couvrira pas comment TypeScript interagit avec les autres outils de l'écosystème JavaScript, sauf si nécessaire. Les problématiques de configuration de TypeScript avec Webpack, Rollup, Parcel, React, Babel, Closure, Lerna, Rush, Bazel, Preact, Vue, Angular, Svelte, jQuery, Yarn, or npm sont hors-sujet - et peuvent être trouvées dans les documentations des outils concernés.
 
-## Get Started
+## Commencer
 
-Before getting started with [The Basics](/docs/handbook/2/basic-types.html), we recommend reading one of the following introductory pages. These introductions are intended to highlight key similarities and differences between TypeScript and your favored programming language, and clear up common misconceptions specific to those languages.
+Avant de commencer avec les [Bases](/docs/fr/handbook/2/basic-types.html), nous recommandons de commencer par l'une de ces pages d'introduction. Ces introductions ont pour objectif de mettre en lumière les similarités et différences importantes entre votre langage de prédilection et TypeScript, pour clarifier tout malentendu ou confusion.
 
-- [TypeScript for New Programmers](/docs/handbook/typescript-from-scratch.html)
-- [TypeScript for JavaScript Programmers](/docs/handbook/typescript-in-5-minutes.html)
-- [TypeScript for OOP Programmers](/docs/handbook/typescript-in-5-minutes-oop.html)
-- [TypeScript for Functional Programmers](/docs/handbook/typescript-in-5-minutes-func.html)
+- [TypeScript pour les nouveaux programmeurs](/docs/fr/handbook/typescript-from-scratch.html)
+- [TypeScript pour les programmeurs JavaScript](/docs/fr/handbook/typescript-in-5-minutes.html)
+- [TypeScript pour les programmeurs Java/C#](/docs/fr/handbook/typescript-in-5-minutes-oop.html)
+- [TypeScript pour les programmeurs fonctionnels (en anglais)](/docs/handbook/typescript-in-5-minutes-func.html)
 
-Otherwise, jump to [The Basics](/docs/handbook/2/basic-types.html) or grab a copy in [Epub](/assets/typescript-handbook.epub) or [PDF](/assets/typescript-handbook.pdf) form.
+Sinon, vous pouvez obtenir une copie en [Epub](/assets/typescript-handbook.epub) ou [PDF](/assets/typescript-handbook.pdf).
