diff --git a/docs/documentation/fr/handbook-v2/The Handbook.md b/docs/documentation/fr/handbook-v2/The Handbook.md index dffe801ad..ebe86bf37 100644 --- a/docs/documentation/fr/handbook-v2/The Handbook.md +++ b/docs/documentation/fr/handbook-v2/The Handbook.md @@ -8,7 +8,7 @@ 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. É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. +30 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. 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. diff --git a/docs/documentation/ko/handbook-v2/The Handbook.md b/docs/documentation/ko/handbook-v2/The Handbook.md index 279fb63c6..a508eda0a 100644 --- a/docs/documentation/ko/handbook-v2/The Handbook.md +++ b/docs/documentation/ko/handbook-v2/The Handbook.md @@ -8,7 +8,7 @@ handbook: "true" ## 핸드북에 대해서 (About this Handbook) -JavaScript는 프로그래밍 커뮤니티에 도입된 지 20년이 지난 지금, 가장 널리 퍼진 cross-platform 언어 중 하나입니다. JavaScript는 웹 페이지에 사소한 상호작용을 추가하기 위한 작은 스크립팅 언어로 시작하여, 규모에 상관없이 프론트엔드와 백엔드 애플리케이션에서 선택 가능한 언어로 성장했습니다. JavaScript로 작성된 프로그램의 크기, 범위 및 복잡성은 기하급수적으로 커졌지만, 다른 코드 단위 간의 관계를 표현하는 JavaScript 언어의 능력은 그렇지 못했습니다. JavaScript의 다소 특이한 런타임 의미 체계(runtime semantics)와 더불어, 언어와 프로그램 복잡성 간의 불일치는 JavaScript 개발을 규모에 맞게 관리하기 어려운 작업으로 만들었습니다. +JavaScript는 프로그래밍 커뮤니티에 도입된 지 30년이 지난 지금, 가장 널리 퍼진 cross-platform 언어 중 하나입니다. JavaScript는 웹 페이지에 사소한 상호작용을 추가하기 위한 작은 스크립팅 언어로 시작하여, 규모에 상관없이 프론트엔드와 백엔드 애플리케이션에서 선택 가능한 언어로 성장했습니다. JavaScript로 작성된 프로그램의 크기, 범위 및 복잡성은 기하급수적으로 커졌지만, 다른 코드 단위 간의 관계를 표현하는 JavaScript 언어의 능력은 그렇지 못했습니다. JavaScript의 다소 특이한 런타임 의미 체계(runtime semantics)와 더불어, 언어와 프로그램 복잡성 간의 불일치는 JavaScript 개발을 규모에 맞게 관리하기 어려운 작업으로 만들었습니다. 프로그래머들이 작성하는 가장 흔한 오류는 타입 오류입니다: 다른 종류의 값이 예상되는 곳에 특정한 값이 사용된 경우입니다. 이는 단순한 오타, 라이브러리 API를 이해하지 못한 것, 런타임 동작에 대한 잘못된 가정 또는 다른 오류 때문일 수 있습니다. TypeScript의 목표는 JavaScript 프로그램의 정적 타입 검사자 입니다. 즉, 코드가 실행되기 전에 실행하고(정적), 프로그램 타입이 정확한지 확인하는 도구(타입 검사)입니다. diff --git a/docs/documentation/pl/handbook-v2/The Handbook.md b/docs/documentation/pl/handbook-v2/The Handbook.md index 1127e6d13..4eae17b60 100644 --- a/docs/documentation/pl/handbook-v2/The Handbook.md +++ b/docs/documentation/pl/handbook-v2/The Handbook.md @@ -7,7 +7,7 @@ oneline: Twoje pierwsze kroki w nauce TypeScript ## Kilka słów o Przewodniku -Prawie 20 lat po jego powstaniu, JavaScript jest dzisiaj jednym z najbardziej rozpowszechnionych języków programowania stworzonych do tej pory. Początkowo był niepozornym językiem skryptowym używanym na stronach internetowych do dodawania prostych elementów interaktywnych, jednak z biegiem czasu znacznie zwiększył swoje rozmiary i możliwości, będąc teraz często wybieranym we frontendzie i backendzie aplikacji każdego możliwego rozmiaru. Choć zarówno wielkość, zastosowanie i złożoność programów pisanych w JavaScript gwałtownie rośnie, zdolność tego języka do określenia związków pomiędzy poszczególnymi elementami kodu pozostała niezmienna. Dość osobliwa semantyka w połączeniu z tą właśnie różnicą pomiędzy złożonością języka i pisanych w nim programów stworzyły niekomfortową sytuację, gdzie tworzenie nowego oprogramowania stało się niezwykle trudne na większą skalę. +Prawie 30 lat po jego powstaniu, JavaScript jest dzisiaj jednym z najbardziej rozpowszechnionych języków programowania stworzonych do tej pory. Początkowo był niepozornym językiem skryptowym używanym na stronach internetowych do dodawania prostych elementów interaktywnych, jednak z biegiem czasu znacznie zwiększył swoje rozmiary i możliwości, będąc teraz często wybieranym we frontendzie i backendzie aplikacji każdego możliwego rozmiaru. Choć zarówno wielkość, zastosowanie i złożoność programów pisanych w JavaScript gwałtownie rośnie, zdolność tego języka do określenia związków pomiędzy poszczególnymi elementami kodu pozostała niezmienna. Dość osobliwa semantyka w połączeniu z tą właśnie różnicą pomiędzy złożonością języka i pisanych w nim programów stworzyły niekomfortową sytuację, gdzie tworzenie nowego oprogramowania stało się niezwykle trudne na większą skalę. Błędy najczęściej popełniane przez programistów i programistki można określić jako błędy typów: pewna konkretna wartość została użyta tam, gdzie oczekiwany był inny rodzaj wartości. Głównymi powodami takich błędów są zazwyczaj proste literówki, nieznajomość interfejsu programistycznego (API) używanej zewnętrznej biblioteki lub też niepoprawny przewidywany wynik uruchamianego programu. TypeScript chce być statycznym kontrolerem typów dla programów napisanych w JavaScript - innymi słowy, narzędziem, które w statyczny sposób działa przed właściwym kodem, sprawdzając poprawność typów w programie.