|
2 | 2 |
|
3 | 3 | Наш код повинен бути настільки зрозумілим та читабельним, наскільки це можливо.
|
4 | 4 |
|
5 |
| -Насправді мистецтво програмування — це брати складну задачу і писати код, який одночасно і розв'язує задачу, і залишається зрозумілим людині. Саме тут хороший стиль коду стає у пригоді. |
| 5 | +Насправді мистецтво програмування — це брати складну задачу і писати код, який одночасно і розв'язує задачу, і залишається зрозумілим людині. І хороший стиль коду тут неабияк стає у пригоді. |
6 | 6 |
|
7 | 7 | ## Синтаксис
|
8 | 8 |
|
@@ -42,7 +42,7 @@ if (n < 0) {
|
42 | 42 |
|
43 | 43 | ### Фігурні дужки
|
44 | 44 |
|
45 |
| -У більшості JavaScript проєктів фігурні дужки написані у так званому "Єгипетському" стилі, де дужка що відкриває блок знаходиться не на новому рядку, а на тому ж, що й відповідне ключове слово. Також потрібно додавати перед нею пробіл. Наприклад: |
| 45 | +У більшості JavaScript проєктів фігурні дужки написані у так званому "Єгипетському" стилі, де дужка, що відкриває блок знаходиться не на новому рядку, а на тому ж, що й відповідне ключове слово. Також потрібно додавати перед нею пробіл. Наприклад: |
46 | 46 |
|
47 | 47 | ```js
|
48 | 48 | if (condition) {
|
|
104 | 104 | }
|
105 | 105 | ```
|
106 | 106 |
|
107 |
| -Максимальну довжину рядка визначається командою. Зазвичай це `80` або `120` символів. |
| 107 | +Максимальну довжину рядка слід встановлювати на рівні всієї команди (людської, від слова team). Зазвичай встановлюють `80` або `120` символів. |
108 | 108 |
|
109 | 109 | ### Відступи
|
110 | 110 |
|
|
151 | 151 |
|
152 | 152 | Крапку з комою треба ставити після кожного виразу, навіть тоді, коли є можливість їх пропустити.
|
153 | 153 |
|
154 |
| -Є мови програмування, у яких крапка з комою є дійсно необов'язковими та рідко використовуються. Проте у JavaScript є ситуації коли перенесення строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Більше детально про це знайдете у розділі <info:structure#semicolon>. |
| 154 | +Є мови програмування, у яких крапка з комою є дійсно необов'язковими та рідко використовуються. Проте у JavaScript є ситуації коли перенесення строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Детальніше про це можна почитати в розділі <info:structure#semicolon>. |
155 | 155 |
|
156 | 156 | Якщо ви досвідчений JavaScript програміст, ви можете обрати стиль коду без крапки з комою, наприклад [StandardJS](https://standardjs.com/). Інакше, краще використовувати крапку з комою для того, щоб уникнути підводних каменів. Більшість розробників використовують крапку з комою.
|
157 | 157 |
|
@@ -180,7 +180,7 @@ for (let i = 0; i < 10; i++) {
|
180 | 180 | }
|
181 | 181 | ```
|
182 | 182 |
|
183 |
| -Схожим чином ми можемо змінити `if/else` та `return`. |
| 183 | +Схожим чином ми можемо змінити `if`/`else` та `return`. |
184 | 184 |
|
185 | 185 | Наприклад, дві конструкції нижче є ідентичними.
|
186 | 186 |
|
@@ -275,13 +275,13 @@ function pow(x, n) {
|
275 | 275 |
|
276 | 276 | Причиною цього є те, що коли ми читаємо код, перш за все ми хочемо зрозуміти *що він робить*. Якщо головний код іде першим - це стає зрозумілим з самого початку. Тоді, можливо ми навіть не будемо читати функції взагалі, особливо якщо їх імена відповідають тому, що вони роблять.
|
277 | 277 |
|
278 |
| -## Посібники зі Стилю Коду |
| 278 | +## Style Guide (Посібник зі Стилю Коду) |
279 | 279 |
|
280 |
| -Посібник зі стилю коду містить загальні правила "як писати" код, наприклад, які лапки використовувати, скільки пробілів ставити для відступу, максимальну довжину рядка, і таке інше. Тобто, багато дрібниць. |
| 280 | +Style Guide містить загальні правила "як писати" код. Наприклад які лапки використовувати, скільки пробілів ставити для відступу, максимальну довжину рядка, і таке інше. Тобто, багато дрібниць. |
281 | 281 |
|
282 |
| -Коли всі члени команди використовують посібник зі стилю, код виглядає однаковим, незалежно від того, хто з команди його написав. |
| 282 | +Коли всі члени команди використовують однаковий style guide, код виглядає однаковим, незалежно від того, хто з команди його написав. |
283 | 283 |
|
284 |
| -Звичайно, кожна команда може завжди створити свій посібник зі стилю, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш відповідний. |
| 284 | +Звичайно, кожна команда може завжди створити свій style guide, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш відповідний. |
285 | 285 |
|
286 | 286 | Деякі популярні посібники:
|
287 | 287 |
|
@@ -313,7 +313,7 @@ function pow(x, n) {
|
313 | 313 |
|
314 | 314 | 1. Встановіть [Node.js](https://nodejs.org/).
|
315 | 315 | 2. Встановіть ESLint, використовуючи команду `npm install -g eslint` (npm – це менеджер JavaScript пакетів (модулів)).
|
316 |
| -3. Створіть файл конфігурації `.eslintrc` в корні вашого JavaScript проєкту (у директорії, що містить всі ваші файли). |
| 316 | +3. Створіть файл конфігурації `.eslintrc` в корені вашого JavaScript проєкту (у директорії, що містить всі ваші файли). |
317 | 317 | 4. Встановіть/увімкніть плагін для вашого редактора, який інтегрується з ESLint. Більшість редакторів мають такий плагін.
|
318 | 318 |
|
319 | 319 | Ось приклад файлу `.eslintrc`:
|
|
0 commit comments