Update article.md

Author: taleksina

1-js/03-code-quality/04-ninja-code/article.md

@@ -2,7 +2,7 @@
 
 
 ```quote author="Конфуцій (Бесіди і судження)"
-Навчання без міркування — даремне, міркування без навчання — небезпечне
+Навчання без міркування — даремне, міркування без навчання — небезпечне.
 ```
 
 Ніндзя-програмісти минулого використовували ці хитрощі, щоб загострити розум тих, хто буде підтримувати їхній код.
@@ -39,11 +39,11 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 ## Однолітерні змінні
 
 ```quote author="Лао-цзи (Дао де цзін)"
-Дао безсловесне. Ім’я, яке можна назвати,
-не є постійним ім’ям.
+Дао безсловесне.
+Ім’я, яке можна назвати, не є постійним ім’ям.
 ```
 
-Ще один спосіб писати стислий код — використовувати однолітерні змінні. Наприклад, `a`, `b` або `c`.
+Ще один спосіб писати стислий код — використовувати однолітерні змінні. Наприклад: `a`, `b` або `c`.
 
 Коротка змінна зникає у коді, наче ніндзя у лісі. Ніхто не зможе знайти її використовуючи "пошук" редактора. І навіть якщо її знайдуть, вони не зможуть "розшифрувати" за що саме змінні `a` чи `b` відповідають.
 
@@ -67,21 +67,21 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 ## Будьте абстрактними
 
 ```quote author="Лао-цзи (Дао де цзін)"
-Великий квадрат не має кутів,<br>
-Великий глек довго ліпиться,<br>
-Великий звук не можна почути,<br>
+Великий квадрат не має кутів,
+Великий глек довго ліпиться,
+Великий звук не можна почути,
 Великий образ неозорий.
 ```
 
 Обираючи ім’я, намагайтесь використовувати найбільш абстрактне слово. Прикладом може бути `obj`, `data`, `value`, `item`, `elem` тощо.
 
-- **`data` є ідеальним варіантом для назви змінної.** Використовуйте його всюди, де зможете. І справді, кожна змінна має *дані*, вірно?
+- **`data` є ідеальним варіантом для назви змінної.** Використовуйте його всюди, де можете. І справді, кожна змінна має *дані*, вірно?
 
-    ...Що робити, якщо назва `data` вже зайнята? Спробуйте `value` — вона також універсальна. Врешті-решт, змінна набуває якесь *значення*.
+    ...А що робити, якщо назва `data` вже зайнята? Спробуйте `value` — вона також універсальна. Врешті-решт, кожна змінна набуває якесь *значення*.
 
 - **Добирайте ім’я змінним згідно з їхнім типом: `str`, `num`...**
 
-    Спробуйте. Той, що щойно став на шлях ніндзя, може засумніватися чи вони дійсно такі корисні. Авжеж!
+    Спробуйте. Той, що щойно став на шлях ніндзя, може засумніватися чи дійсно вони такі корисні. Авжеж!
 
     Так, ім’я змінної дещо означає. Це допомагає зрозуміти, що ми використовуємо: рядок, число, чи щось ще. Проте коли сторонні люди намагатимуться зрозуміти код, вони будуть здивовані, що інформація про те, що саме містить змінна, відсутня. У результаті вони не зможуть змінити ваш добре обміркований код.
 
@@ -99,45 +99,45 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 
 Змішуйте їх всюди, де це можливо.
 
-Швидко прочитати такий код неможливо. А якщо виникла друкарська помилка... Мммм... Це надовго, час випити чаю.
+Швидко прочитати такий код неможливо. А якщо стався хибодрук... Мммм... Це надовго, час випити чаю.
 
 
-## Хитрі синоніми
+## Хитромудрі синоніми
 
 ```quote author="Лао-цзи (Дао де цзін)"
 Істина, яка може бути виражена словами, не є правдива істина. Ім’я, яке може бути названо, не є правдиве ім’я.
 ```
 
-Використання *схожих* імен для *однакових* речей зробить ваше життя цікавішим і покаже рівень вашої креативності публіці.
+Використання *схожих* імен для *однакових* речей зробить життя цікавішим і продемонструє рівень вашої креативності.
 
-Наприклад, розглянемо префікси функцій. Якщо функція показує повідомлення на екрані — почніть назву з `display…` (наприклад, `displayMessage`). І коли інша функція показуватиме щось ще на екрані (скажімо, ім’я користувача), почніть її назву з `show…` (наприклад, `showName`).
+Наприклад, розглянемо префікси функцій. Якщо функція виводить повідомлення на екран — почніть назву з `display…`, як то `displayMessage`. А для іншої функції, що показуватиме ще щось на екрані (скажімо, ім’я користувача), оберіть назву з `show…` (наприклад, `showName`).
 
-Тобто натякніть, що є деяка тонка різниця між цими функціями, хоча насправді її немає.
+Натякніть, що є деяка тонка відмінність між цими функціями, хоча насправді її немає.
 
-Домовтесь зі своїми ніндзя-колегами, що якщо Іван починає називати функції, що показують щось, використовуючи `display...`, тоді Петро може використовувати `render..`, а Ганна — `paint...`. Зауважте, наскільки цікавим та різноманітним став ваш код.
+Домовтесь зі своїми ніндзя-колегами, що якщо Іван починає називати функції, що показують щось, використовуючи `display...`, тоді Петро може використовувати `render..`, а Ганна — `paint...`. Зауважте, наскільки цікавим та різноманітним став код.
 
 ...А тепер коронний прийом!
 
-Для функцій, у яких дійсно є важлива різниця, використовуйте однаковий префікс!
+Для функцій, у яких дійсно є важливі відмінності, використовуйте однаковий префікс!
 
-Наприклад, функція `printPage(page)` використовуватиме принтер. А `printText(text)` виводитиме текст на екран. Нехай люди, що неосвічені у вашому коді, здогадуються щодо схожої функції `printMessage`: "Куди буде виведено повідомлення? На принтер чи на екран?". Для збільшення ефекту неочікуваності, функція `printMessage(message)` повинна вивести повідомлення в нове вікно!
+Наприклад, функція `printPage(page)` використовуватиме принтер. А `printText(text)` виводитиме текст на екран. Нехай люди, що неосвічені у вашому коді, розмірковують щодо схожої функції `printMessage`: "Куди буде виведено повідомлення? На принтер чи на екран?". Будьте послідовними, функція `printMessage(message)` повинна вивести повідомлення в нове вікно!
 
 ## Використовуйте імена повторно
 
 ```quote author="Лао-цзи (Дао де цзін)"
-При встановленні порядку<br>
-з’явилися імена.<br>
-Оскільки виникли імена,<br>
+При встановленні порядку
+з’явилися імена.
+Оскільки виникли імена,
 потрібно знати межу їх використання.
 ```
 
 Вводіть нову змінну тільки тоді, коли це вкрай необхідно.
 
-Натомість, використовуйте повторно наявні змінні. Просто записуйте у них нові значення.
+Натомість, використовуйте наявні змінні повторно. Просто записуйте у них нові значення.
 
 У функції намагайтесь використовувати лише змінні, що були передані у якості параметрів.
 
-Це суттєво ускладнить розуміння того, що саме міститься у змінній *зараз*, і звідки воно там. Метою цих дій є розвиток інтуїції та пам’яті людини, котра прочитає цей код. Людина зі слабкою інтуїцією аналізуватиме такий код рядок за рядком і слідкуватиме за змінами у кожному блоці коду.
+Це суттєво ускладнить розуміння того, що саме міститься у змінній *зараз*, і звідки воно там. Метою цих дій є розвиток інтуїції та пам’яті людини, котра читає цей код. Людина зі слабкою інтуїцією аналізуватиме такий код рядок за рядком і слідкуватиме за змінами у кожному блоці коду.
 
 **Просунутим варіантом такого підходу є непомітна (!) заміна значення змінної на щось дуже схоже всередині циклу або функції.**
 
@@ -153,9 +153,9 @@ function ninjaFunction(elem) {
 }
 ```
 
-Програміст, в якого буде бажання використати `elem` у другій частині коду, буде здивований... Тільки під час налагодження, після розбору коду він зрозуміє, що працює з клоном!
+Колега-програміст, в якого буде бажання використати `elem` у другій частині коду, буде здивований... Тільки під час налагодження, після розбору коду він зрозуміє, що працює з клоном!
 
-Таке трапляється доволі часто. Ефективний прийом, навіть проти досвідчених ніндзя.
+Таке трапляється доволі часто. Вбивчий прийом, навіть проти досвідчених ніндзя.
 
 ## Підкреслення задля розваги
 
@@ -175,7 +175,7 @@ function ninjaFunction(elem) {
 ## Перекриття зовнішніх змінних
 
 ```quote author="Ґуань Їнь-цзи"
-Той, що перебуває на світлі, не може нічого побачити в темряві.<br>
+Той, що перебуває на світлі, не може нічого побачити в темряві.
 Той, що перебуває у темряві, побачить все, що перебуває на світлі.
 ```
 
@@ -201,40 +201,40 @@ function render() {
 
 ## Побічні ефекти всюди!
 
-Є функції, які начебто нічого не змінюють. Наприклад, `isReady()`, `checkPermission()`, `findTags()`... Припускається, що такі функції виконують обчислення та повертають результат без впливу на те, що міститься за межами функції. Іншими словами, без "побічних ефектів".
+Є функції, які начебто нічого не змінюють. Наприклад: `isReady()`, `checkPermission()`, `findTags()`... Припускається, що такі функції виконують обчислення та повертають результат без впливу на те, що міститься за межами функції. Іншими словами, без "побічних ефектів".
 
-**Дійсно, гарним прийомом є додавати "корисну" дію до них, окрім їхньої основної задачі.**
+**Дійсно гарним прийомом є додавати "корисну" дію до них, окрім їхньої основної задачі.**
 
 Вираз приголомшеного подиву на обличчі вашого колеги, коли він побачить, що функція з ім’ям `is..`, `check..` чи `find...` щось змінює, неодмінно розширить межі його розуму.
 
 **Іншим способом здивувати є повернення нестандартного результату.**
 
 Покажіть своє оригінальне мислення! Нехай виклик функції `checkPermission` поверне не `true/false`, а складний об’єкт з результатом перевірки.
 
-Розробники, що намагатимуться написати `if (checkPermission(..))`, будуть цікавитись, чому воно не працює. Скажіть їм: "Читайте документацію!". І дайте їм почитати цю статтю.
+Розробники, що намагатимуться написати `if (checkPermission(..))`, будуть дивуватись, чому воно не працює. Скажіть їм: "Читайте документацію!". І дайте їм почитати цю статтю.
 
 
 ## Могутні функції!
 
 ```quote author="Лао-цзи (Дао де цзін)"
-Вічне Дао пронизує Собою все.<br>
+Вічне Дао пронизує Собою все.
 Воно є і праворуч, і ліворуч.
 ```
 
 Не треба обмежувати алгоритм функції лише тим, що пов’язано з її ім’ям. Мисліть ширше.
 
 Наприклад, функція `validateEmail(email)` може (окрім перевірки адреси електронної пошти на відповідність правилам) показувати повідомлення про помилку та пропонувати ввести нову адресу.
 
-Додаткові дії не мусять бути зрозумілими з імені функції. Справжній ніндзя розробник зробить їх також неочевидними і в самому коді.
+Додаткові дії не мусять бути зрозумілими з імені функції. Справжній ніндзя-розробник зробить їх також неочевидними і в самому коді.
 
 **Поєднання декількох дій в одну захищає ваш код від повторного використання.**
 
-Уявіть собі, що інший розробник захоче тільки перевірити адресу електронної пошти без виводу жодних повідомлень. Ваша функція `validateEmail(email)` робить обидві ці дії, а, значить, не підійде йому. Тому вони не потурбують вас під час медитації питаннями щодо цієї функції.
+Уявіть собі, що інший розробник захоче тільки перевірити адресу електронної пошти без виводу жодних повідомлень. Ваша функція `validateEmail(email)` робить ці обидві дії, тому не підійде йому. Отже, ніхто не потурбує вас під час медитації питаннями щодо цієї функції.
 
 ## Підсумки
 
-Всі "поради", зазначені вище, взяті з реального коду... Який іноді писали навіть досвідчені розробники. Можливо, навіть досвідченіші за вас ;)
+Всі "поради", зазначені вище, взяті з реального коду... Іноді написаного доволі досвідченими розробниками. Можливо, навіть досвідченішими за вас ;)
 
-- Дотримуйтесь їх — і ваш код буде мати повно несподіванок.
-- Дотримуйтесь їх усіх, і ваш код буде дійсно вашим — ніхто не захоче його читати, і тим паче — змінювати.
-- Дотримуйтесь їх усіх — і ваш код стане цінним уроком для молодих розробників, які шукають просвітлення.
+- Дотримуйтесь деяких з цих порад — і у вашому коді буде повно несподіванок.
+- Дотримуйтесь більшості з цих порад — і ваш код буде дійсно вашим; ніхто не захоче його читати, тим паче — змінювати.
+- Дотримуйтесь усіх порад — і ваш код стане неоціненним уроком для молодих розробників, які шукають просвітлення.