feat(1-02-01-hello-world): Fix language mistakes in 03-comments

Author: ltlaitoff

1-js/03-code-quality/03-comments/article.md

@@ -43,7 +43,7 @@ function showPrimes(n) {
 }
 ```
 
-Кращим варінтом було б помістити код в окрему функцію `isPrime`:
+Кращим варіантом було б помістити код в окрему функцію `isPrime`:
 
 
 ```js
@@ -90,7 +90,7 @@ for(let t = 0; t < 3; t++) {
 // ...
 ```
 
-Тоді кращим варінтом буде замінити його на окремі функції:
+Тоді кращим варіантом буде замінити його на окремі функції:
 
 ```js
 addWhiskey(glass);
@@ -113,14 +113,14 @@ function addJuice(container) {
 
 Знову ж таки, ім'я функцій самі описують, що в них відбувається. Немає потреби коментувати такий код. Також кращою є структура коду, коли він розподілений. Стає зрозумілим, що функція робить, що вона приймає і що повертає.
 
-Насправді, ми не можемо уникнути повністю "пояснювальних" коментарів. Є складні алгоритми. Також існують деякі "прийоми" для оптимізації. Проте, як правило, ми повинні намагатись залишати код простим та самоописним.
+Насправді ми не можемо уникнути повністю "пояснювальних" коментарів. Є складні алгоритми. Також існують деякі "прийоми" для оптимізації. Проте, як правило, ми повинні намагатись залишати код простим та самоописним.
 
 ## Хороші коментарі
 
 Тож, пояснювальні коментарі зазвичай погані. Які ж тоді хороші?
 
 Описуйте архітектуру
-: Додавайте опис компонентів висого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду з висоту пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.
+: Додавайте опис компонентів вищого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду з висоту пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.
 
 Документуйте параметри функції та її використання
 : Існує спеціальний синтаксис [JSDoc](https://uk.wikipedia.org/wiki/JSDoc) для документації функції: її використання, параметри, значення, що повертає.
@@ -148,12 +148,12 @@ function pow(x, n) {
 Чому завдання було вирішено у такий спосіб?
 : Те, що написано є дуже важливим. Проте, те, що *не* написано може бути ще більш важливим, щоб зрозуміти, що саме відбувається. Чому завдання було вирішено саме у такий спосіб? Код не дає відповідь на це питання.
 
-Якщо існує декілька способів вирішення завдання, чому саме цей? Особливо, якщо цей спосіб не самий очевидний.
+Якщо існує декілька способів вирішення завдання, чому саме цей? Особливо, якщо цей спосіб не найбільш очевидний.
 
 Без таких коментарів можлива наступна ситуація:
 1. Ви (або ваш колега) відкриває код, написаний колись раніше, і бачить, що він "неоптимальний".
 2. Ви думаєте: "Який я був недосвідчений, і наскільки розумнішим я став зараз", і переписуєте код використовуючи "більш очевидний і правильний" варіант.
-3. ...Бажання переписати код було хорошим. Але в процесі ви помічаєте, що "більш очевидне" рішення не є оптимальним. Ви навіть смутно пригадуєте чому воно так, тому що колись давно вже намаглись спробувати такий варіант. Ви вертаєте правильне рішення, проте час було витрачено даремно.
+3. ...Бажання переписати код було хорошим. Але в процесі ви помічаєте, що "більш очевидне" рішення не є оптимальним. Ви навіть смутно пригадуєте чому воно так, тому що колись давно вже намагались спробувати такий варіант. Ви вертаєте правильне рішення, проте час було витрачено даремно.
 
 Коментарі, які пояснюють рішення є дуже важливими. Вони допомагають продовжувати розробку правильним шляхом.
 
@@ -177,4 +177,4 @@ function pow(x, n) {
 - Які описують, як код працює і що він робить.
 - Пишіть їх тільки у тому випадку, коли не має змоги написати простий та самоописний код, якому пояснення не потрібні.
 
-Коментарі також використовуються інструментами для автоматичної генерації документації, наприклад JSDoc3 - вони читають їх та генерують HTML-документи (або документи у іншому форматі).
+Коментарі також використовуються інструментами для автоматичної генерації документації, наприклад JSDoc3 - вони читають їх та генерують HTML-документи (або документи в іншому форматі).