tools

Author: Nataliia Karpenko

docs/tools/changelog.md

@@ -1,19 +1,20 @@
 ## Changelog 
-> Reading a markdown file with the progress in the project is easier than reading a commit log.
+> Читати файл розмітки з прогресом у проекті легше, ніж читати журнал фіксації.
 
-Automatic changelog generation from commit messages is a fairly common pattern nowadays. There is a project called [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) that generates a changelog from commit messages that follow a *convention*. 
+Автоматичне створення журналу змін із повідомлень комітів є досить поширеним шаблоном у наш час. Є проект під назвою [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) який генерує журнал змін із повідомлень про фіксацію, які відповідають *convention*.
 
 ### Commit message convention
-The most common convention is the *angular* commit messages convention which is [detailed here](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines).
+Найпоширенішою угодою є угода про повідомлення фіксації  *angular*, яка  [детально описана тут . Налаштування](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines).
 
 ### Setup
-* Install: 
+
+* встановити:
 
 ```bash
 npm install standard-version -D
 ```
 
-* Add a `script` target to your `package.json`: 
+* Додайте ціль  `script` до свого `package.json`:
 
 ```js
 {
@@ -23,7 +24,7 @@ npm install standard-version -D
 }
 ```
 
-* Optionally : To automatically push the new *git commit and tag* plus publish to npm add a `postrelease` script: 
+* Додатково: щоб автоматично надсилати новий  *git commit and tag* плюс публікацію до npm, додайте `postrelease` сценарій:
 
 ```js
 {
@@ -36,13 +37,13 @@ npm install standard-version -D
 
 ### Releasing 
 
-Simply run: 
+Простий запуск: 
 
 ```bash
 npm run release
 ```
 
-Based on the commit messages `major` | `minor` | `patch` is automatically determined. To *explicitly* specify a version you can specify `--release-as` e.g.: 
+На основі повідомлень тип версії:  `major` | `minor` | `patch` визначається автоматично. Щоб *explicitly* явно вказати версію, ви можете вказати `--release-as` наприклад::
 
 ```bash
 npm run release -- --release-as minor

docs/tools/eslint.md

@@ -1,26 +1,30 @@
 # ESLint
 
-ESLint existed to lint JavaScript, but now it is also becoming the defacto linter for [TypeScript](https://github.com/Microsoft/TypeScript/issues/29288), thanks to the [collaboration](https://eslint.org/blog/2019/01/future-typescript-eslint) between the two teams.
+ESLint існував для лінтування JavaScript, але тепер він також стає дефакто лінтером для [TypeScript](https://github.com/Microsoft/TypeScript/issues/29288), завдяки 
+[співпраці](https://eslint.org/blog/2019/01/future-typescript-eslint) між двома командами.
 
 ## Install
+Встановлення
 
-To setup ESLint for TypeScript you need the following packages:
+Щоб налаштувати ESLint для TypeScript, вам потрібні такі пакети:
 
 ```sh
 npm i eslint eslint-plugin-react @typescript-eslint/parser @typescript-eslint/eslint-plugin
 ```
 
-> TIP: eslint calls packages that contain lint rules as "plugin"
+> TIP: eslint називає свої пакети з правилами "plugin"
 
 * eslint : Core eslint 
-* eslint-plugin-react : For react rules provided by eslint. [Supported rules list](https://github.com/yannickcr/eslint-plugin-react#list-of-supported-rules)
-* @typescript-eslint/parse : To allow eslint to understand ts / tsx files 
-* @typescript-eslint/eslint-plugin : For TypeScript rules. [Supported rules list](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/eslint-plugin#supported-rules)
+* eslint-plugin-react : Правіла для react від eslint. [Supported rules list](https://github.com/yannickcr/eslint-plugin-react#list-of-supported-rules)
+* @typescript-eslint/parse : Дозволяє eslint розуміти ts / tsx files 
+* @typescript-eslint/eslint-plugin : Для правил TypeScript. [Supported rules list](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/eslint-plugin#supported-rules)
 
-> As you can see there are two eslint packages (for use with js or ts) and two @typescript-eslint packages (for use with ts). So the overhead for TypeScript is not *that much*.
+> Как ви бачите, 2 eslint пакети (для використання js та ts) та 2 @typescript-eslint пакета (для ts). Така звишена увага для TypeScript не *that much*.
 
 ## Configure 
-Create `.eslintrc.js`: 
+Конфігурація
+
+Створіть `.eslintrc.js`:
 
 ```js
 module.exports = {
@@ -34,15 +38,15 @@ module.exports = {
     'plugin:@typescript-eslint/recommended',
   ],
   rules:  {
-    // Overwrite rules specified from the extended configs e.g. 
-    // "@typescript-eslint/explicit-function-return-type": "off",
-  }
+  // Правила перезапису, указані в розширених конфігураціях, наприклад
+   // "@typescript-eslint/explicit-function-return-type": "off",
 }
 ```
 
 ## Run
+Використання
 
-In your `package.json` add to `scripts`: 
+У вашому `package.json` додайте до `scripts`:
 
 ```json
 {
@@ -52,12 +56,14 @@ In your `package.json` add to `scripts`:
 }
 ```
 
-Now you can `npm run lint` to validate.
+Тепер ви можете `npm run lint` для перевірки.
 
 ## Configure VSCode 
+Конфігурація VSCode 
+
+* Встановіть розширення https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint
 
-* Install extension https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint
-* Add to `settings.json`:
+* Додайте до `settings.json`:
 ```js
 "eslint.validate":  [
   "javascript",

docs/tools/husky.md

@@ -1,10 +1,11 @@
 # Husky 
 
-> Husky can prevent bad commits, pushes and more 🐶!
+> Husky може захистити вас від поганих комітів та відправок 🐶!
 
-If you want to run some JavaScript / TypeScript code before a commit takes place, husky is the tool for that. 
+Якщо ви хочете запустити деякий код JavaScript / TypeScript до того, як відбудеться коміт, інструментом для цього є Husky.
+
+Наприклад, ви можете використовувати Husky, щоб переконатися, що файли форматуються prettier автоматично, тож вам більше не доведеться турбуватися про форматування файлів вручну, а натомість зосередитися на меті коду. Ось налаштування:
 
-For example, you can use husky to make sure files are formatted by prettier automatically so you don't have to worry about manually formatting files ever again and focus on the objective of the code instead. Here is the setup: 
 
 * `npm install husky -D`
 * Add `scripts` to `package.json`: 
@@ -13,7 +14,7 @@ For example, you can use husky to make sure files are formatted by prettier auto
     "precommit": "npm run prettier:write",
 ```
 
-Now whenever you commit code and there are any formatting changes that need to be made, you'd get them as a *modified* file in your git log. You can now 
+Тепер щоразу, коли ви фіксуєте код і потрібно внести будь-які зміни форматування, ви отримуватимете їх як *modified* файл у своєму журналі git. Ви можете спробувати зараз
 
-* If you have pushed your code already, simply commit them with a comment `pretty`.
-* If you haven't pushed your code, amend your last commit and look like a superhero.
+* Якщо ви вже просунули (push) свій код, просто зафіксуйте їх у коментарі  `pretty`.
+* Якщо ви не просунули свій код, змініть свій останній комміт і виглядайте як супергерой.

docs/tools/intro.md

@@ -1,2 +1,4 @@
 # Tools
-Here are some great tools that I recommend you use or at least try in your TypeScript projects. 
+Інструменти
+
+Ось кілька чудових інструментів, які я рекомендую вам використовувати або принаймні спробувати у своїх проектах TypeScript.

docs/tools/prettier.md

@@ -1,8 +1,9 @@
 # Prettier 
 
-Prettier is a great tool by facebook that makes code formatting so much easier that it's worth mentioning. Setting up with TypeScript using our recommended project setup (aka everything in `src` folder) is super easy: 
+Prettier — це чудовий інструмент від Facebook, який робить форматування коду настільки простим, що варто згадати про нього. Налаштувати TypeScript за допомогою наших рекомендованих налаштувань проекту (також відомого як усе в папці `src`) надзвичайно просто:
 
 ## Setup 
+Наставлення
 
 * `npm install prettier -D` 
 * Add `scripts` to `package.json`: 
@@ -14,8 +15,10 @@ Prettier is a great tool by facebook that makes code formatting so much easier t
 ```
 
 ## Usage 
-On your build server: 
+Використання
+
+На вашому сервері збірки:
 * `npm run prettier:check` 
 
-During dev (or pre commit hook): 
+Під час розробки (або перед комітом):
 * `npm run prettier:write`