Apply suggestions from code review

Author: dolgachio

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

@@ -2,7 +2,7 @@
 
 
 ```quote author="Конфуцій (Бесіди і судження)"
-Навчання без міркування — даремне, міркування без навчання — небезпечне.
+Навчання без міркування -- даремне, міркування без навчання -- небезпечне.
 ```
 
 Ніндзя-програмісти минулого використовували ці хитрощі, щоб загострити розум тих, хто буде підтримувати їхній код.
@@ -11,19 +11,19 @@
 
 Початківці часом використовують їх навіть краще за ніндзя-програмістів.
 
-Уважно перечитайте ці хитрощі й вирішіть, хто ви є — ніндзя, початківець, чи може ґуру перевірки коду?
+Уважно перечитайте ці хитрощі й вирішіть, хто ви є -- ніндзя, початківець, чи може ґуру перевірки коду?
 
 
 ```warn header="Обережно, іронія!"
 Багато тих, хто намагався піти шляхом ніндзя. Мало тих, кому це вдалося.
 ```
 
 
-## Стислість — сестра таланту
+## Стислість -- сестра таланту
 
 Пишіть якомога коротший код. Покажіть, наскільки ви розумні.
 
-Нехай неочевидні мовні нюанси керують вами.
+Нехай неочевидні особливості мови направляють вас.
 
 Наприклад, розглянемо застосування тернарного оператора `'?'`:
 
@@ -34,7 +34,7 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 
 Круто, справді? Якщо ви напишете щось подібне, то програміст, який натрапить на цей рядок і намагатиметься зрозуміти, яке ж значення має `i`, пізнає неабиякий дзен. І, врешті-решт, прийде до вас за просвітленням.
 
-Скажіть йому, що коротше — це завжди краще. Допоможіть йому стати на шлях ніндзя.
+Скажіть йому, що коротше -- це завжди краще. Допоможіть йому стати на шлях ніндзя.
 
 ## Однолітерні змінні
 
@@ -43,11 +43,11 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 Ім’я, яке можна назвати, не є постійним ім’ям.
 ```
 
-Ще один спосіб писати стислий код — використовувати однолітерні змінні. Наприклад: `a`, `b` або `c`.
+Ще один спосіб писати стислий код -- використовувати однолітерні змінні. Наприклад: `a`, `b` або `c`.
 
-Коротка змінна зникає в коді, наче ніндзя в лісі. Ніхто не зможе знайти її навіть через "пошук" редактора. І бодай її знайдуть, вони не зможуть "розшифрувати" за що саме відповідають змінні `a` чи `b`.
+Коротка змінна зникає в коді, наче ніндзя в лісі. Ніхто не зможе знайти її навіть через "пошук" в редакторі. І бодай її знайдуть, вони не зможуть "розшифрувати" за що саме відповідають змінні `a` чи `b`.
 
-Але є один виняток із правил. Справжній ніндзя ніколи не використовуватиме `i` як лічильник в циклі `"for"`. Де завгодно, тільки не тут! Озирніться — є багато інших екзотичних літер. Наприклад, `x` або `y`.
+Але є один виняток із правил. Справжній ніндзя ніколи не використовуватиме `i` як лічильник в циклі `"for"`. Де завгодно, тільки не тут! Озирніться -- є багато інших екзотичних літер. Наприклад, `x` або `y`.
 
 Екзотична змінна в ролі лічильника особливо доречна, коли тіло циклу займає одну-дві сторінки (чим більше, то краще). У такому випадку ті, хто зануриться глибоко в код циклу, не зможуть швидко здогадатись, що змінна `x` насправді є лічильником.
 
@@ -67,35 +67,35 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 ## Будьте абстрактними
 
 ```quote author="Лао-цзи (Дао де цзін)"
-Великий квадрат не має кутів,
-Великий глек довго ліпиться,
-Великий звук не можна почути,
+Великий квадрат не має кутів,<br>
+Великий глек довго ліпиться,<br>
+Великий звук не можна почути,<br>
 Великий образ неозорий.
 ```
 
 Обираючи ім’я, намагайтесь використовувати найбільш абстрактне слово. Прикладом може бути `obj`, `data`, `value`, `item`, `elem` тощо.
 
 - **`data` є ідеальним варіантом для імені змінної.** Використовуйте його всюди, де можете. І справді, кожна змінна має *дані*, вірно?
 
-    А що робити, якщо ім’я `data` вже зайняте? Спробуйте `value` — воно також універсальне. Врешті-решт, кожна змінна набуває якесь *значення*.
+    А що робити, якщо ім’я `data` вже зайняте? Спробуйте `value` -- воно також універсальне. Врешті-решт, кожна змінна набуває якесь *значення*.
 
 - **Добирайте ім’я змінним згідно з їхнім типом: `str`, `num`...**
 
     Спробуйте. Той, що щойно став на шлях ніндзя, може засумніватися чи дійсно такі імена корисні. Авжеж!
 
     Так, ім’я змінної дещо означає. Це допомагає зрозуміти, що ми використовуємо: рядок, число, чи щось ще. Проте коли сторонні люди намагатимуться зрозуміти код, вони будуть здивовані, що інформація про те, що саме містить змінна, відсутня. У результаті вони не зможуть змінити ваш добре обміркований код.
 
-    Тип змінної досить легко знайти під час налаштування. Але що означає її ім’я? Яку саме строку/число вона зберігає?
+    Тип змінної досить легко знайти під час налаштування. Але що означає її ім’я? Який саме рядок/число вона зберігає?
 
     Жодного шансу дізнатися про це без тривалої медитації!
 
-- **Але що робити, коли й такі імена скінчились?** Просто додайте число: `data1`, `item2`, `elem5`...
+- **Але що робити, коли й такі імена скінчились?** Просто додайте число: `data1, item2, elem5`...
 
 ## Перевірка уваги
 
 Тільки дуже уважний програміст повинен мати шанс зрозуміти ваш код. Проте як це перевірити? 
 
-**Один зі способів — використання схожих імен змінних, наприклад `date` і `data`.**
+**Один зі способів -- використання схожих імен змінних, наприклад `date` і `data`.**
 
 Змішуйте їх всюди, де це можливо.
 
@@ -110,11 +110,11 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 
 Використання *схожих* імен для *однакових* речей зробить життя цікавішим і продемонструє рівень вашої креативності.
 
-Наприклад, розглянемо префікси функцій. Якщо функція виводить повідомлення на екран — почніть ім’я з `display…`, як то `displayMessage`. А для іншої функції, що показуватиме на екрані ще щось (скажімо, ім’я користувача), оберіть ім’я з `show…` (наприклад, `showName`).
+Наприклад, розглянемо префікси функцій. Якщо функція виводить повідомлення на екран -- почніть її ім’я з `display…`, як то `displayMessage`. А для іншої функції, що показуватиме на екрані ще щось (скажімо, ім’я користувача), почніть ім’я з `show…` (наприклад, `showName`).
 
 Натякніть, що є деяка тонка відмінність між цими функціями, хоча насправді її немає.
 
-Домовтесь зі своїми ніндзя-колегами, що якщо Іван починає називати функції, що показують щось, використовуючи `display...`, тоді Петро може використовувати `render..`, а Ганна — `paint...`. Зауважте, наскільки цікавим та різноманітним став код.
+Домовтесь зі своїми ніндзя-колегами, що якщо Микола починає називати функції, що показують щось, використовуючи `display...`, тоді Петро може використовувати `render..`, а Ганна -- `paint...`. Зауважте, наскільки цікавим та різноманітним став код.
 
 А тепер коронний прийом!
 
@@ -125,9 +125,9 @@ i = i ? i < 0 ? Math.max(0, len + i) : i : 0;
 ## Використовуйте імена повторно
 
 ```quote author="Лао-цзи (Дао де цзін)"
-При встановленні порядку
-з’явилися імена.
-Оскільки виникли імена,
+При встановленні порядку<br>
+з’явилися імена.<br>
+Оскільки виникли імена,<br>
 потрібно знати межу їх використання.
 ```
 
@@ -157,7 +157,7 @@ function ninjaFunction(elem) {
 
 Таке трапляється доволі часто. Вбивчий прийом, навіть проти досвідчених ніндзь.
 
-## Підкреслення — це весело
+## Підкреслення -- це весело
 
 Ставте підкреслення `_` та `__` перед іменами змінних. Наприклад, `_name` або `__value`. Краще буде, якщо тільки ви будете розуміти їхнє значення. А ще краще, щоб ніякого значення не було зовсім, додавайте їх задля розваги. Або використовуйте різні значення в різних місцях.
 
@@ -169,7 +169,7 @@ function ninjaFunction(elem) {
 
 Нехай усі бачать, наскільки величні ваші сутності! Читач обов’язково зрадіє таким іменам, як `superElement`, `megaFrame` та `niceItem`.
 
-Справді, з одного боку, дещо все ж таки написано: `super..`, `mega..`, `nice..`. Але, з іншого боку — це не пояснює нічого. Той, хто читатиме ваш код, витратить не одну годину свого оплаченого робочого часу на медитацію і пошуки прихованого значення цих слів.
+Справді, з одного боку, дещо все ж таки написано: `super..`, `mega..`, `nice..`. Але, з іншого боку -- це не пояснює нічого. Той, хто читатиме ваш код, витратить не одну годину свого оплаченого робочого часу на медитацію і пошуки прихованого значення цих слів.
 
 
 ## Перекриття зовнішніх змінних
@@ -217,15 +217,15 @@ function render() {
 ## Могутні функції!
 
 ```quote author="Лао-цзи (Дао де цзін)"
-Вічне Дао пронизує Собою все.
+Вічне Дао пронизує Собою все.<br>
 Воно є і праворуч, і ліворуч.
 ```
 
 Не треба обмежувати алгоритм функції лише тим, що пов’язано з її ім’ям. Мисліть ширше.
 
 Наприклад, функція `validateEmail(email)` може (окрім перевірки адреси електронної пошти на відповідність правилам) показувати повідомлення про помилку та пропонувати ввести нову адресу.
 
-Додаткові дії не мусять бути зрозумілими з імені функції. Справжній ніндзя-програміст зробить їх також неочевидними й в самому коді.
+Додаткові дії не мусять бути зрозумілими з ім'я функції. Справжній ніндзя-програміст зробить їх також неочевидними й в самому коді.
 
 **Поєднання декількох дій в одну захищає ваш код від повторного використання.**
 
@@ -235,6 +235,6 @@ function render() {
 
 Всі "поради", зазначені вище, здобуті з реального коду... Іноді написаного доволі досвідченими програмістами. Можливо, навіть досвідченішими за вас ;)
 
-- Дотримуйтесь деяких з цих порад — і у вашому коді буде повно несподіванок.
-- Дотримуйтесь більшості з цих порад — і ваш код буде дійсно вашим; ніхто не захоче його читати, тим паче — змінювати.
-- Дотримуйтесь усіх порад — і ваш код стане неоціненним уроком для молодих програмістів, які шукають просвітлення.
+- Дотримуйтесь деяких з цих порад -- і у вашому коді буде повно несподіванок.
+- Дотримуйтесь більшості з цих порад -- і ваш код буде дійсно вашим; ніхто не захоче його читати, тим паче -- змінювати.
+- Дотримуйтесь усіх порад -- і ваш код стане безцінним уроком для молодих програмістів, які шукають просвітлення.