Skip to content

Commit 8392e40

Browse files
committed
feat(1-02-01-hello-world): Fix language mistakes in 02-coding-style
1 parent 4eb5f7a commit 8392e40

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

1-js/03-code-quality/02-coding-style/article.md

+15-15
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Наш код повинен бути настільки зрозумілим та читабельним, наскільки це можливо.
44

5-
Насправді, мистецтво програмування — це брати складну задачу і писати код, який одночасно і вирішує задачу, і залишається зрозумілим людині. Саме тут хороший стиль коду стає у нагоді.
5+
Насправді мистецтво програмування — це брати складну задачу і писати код, який одночасно і розв'язує задачу, і залишається зрозумілим людині. Саме тут хороший стиль коду стає у пригоді.
66

77
## Синтаксис
88

@@ -42,7 +42,7 @@ if (n < 0) {
4242

4343
### Фігурні дужки
4444

45-
У більшості JavaScript проєктів фігурні дужки написані у так званому "Єгипетському" стилі, де відкриваюча дужка знаходиться не на новому рядку, а на тому ж, що й відповідне ключове слово. Також потрібно додавати пробіл перед відкриваючою дужкою, наприклад:
45+
У більшості JavaScript проєктів фігурні дужки написані у так званому "Єгипетському" стилі, де дужка що відкриває блок знаходиться не на новому рядку, а на тому ж, що й відповідне ключове слово. Також потрібно додавати перед нею пробіл. Наприклад:
4646

4747
```js
4848
if (condition) {
@@ -56,7 +56,7 @@ if (condition) {
5656

5757
Нижче наведені різні варіанти розташування дужок з коментарями, щоб ви змогли самостійно вирішити який варіант є найбільш читабельним.
5858

59-
1. 😠 Початківці іноді викорустовують таку конструкцію. Це поганий приклад, фігурні дужки не потрібні:
59+
1. 😠 Початківці іноді використовують таку конструкцію. Це поганий приклад, фігурні дужки не потрібні:
6060
```js
6161
if (n < 0) *!*{*/!*alert(`Степінь ${n} не підтримується`);*!*}*/!*
6262
```
@@ -76,7 +76,7 @@ if (condition) {
7676
}
7777
```
7878
79-
Для дуже короткого коду один рядок є прийнятним, наприклад `if (cond) return null`. Але блок коду (останній варінт) зазвичай є більш читабельним.
79+
Для дуже короткого коду один рядок є прийнятним, наприклад `if (cond) return null`. Але блок коду (останній варіант) зазвичай є більш читабельним.
8080
8181
### Довжина рядка
8282
@@ -112,7 +112,7 @@ if (
112112
113113
- **Горизонтальні відступи: 2 або 4 пробіли.**
114114
115-
Горизонтальний відступ робиться за допогою двох або чотирьох пробілів, або за допомогою табуляції (клавіша `key:Tab`). Який відступ вибирати - вирішувати вам. Відступ з пробілам більш поширений на сьогодні.
115+
Горизонтальний відступ робиться за допомогою двох або чотирьох пробілів, або за допомогою табуляції (клавіша `key:Tab`). Який відступ вибирати - вирішувати вам. Відступ з пробілами більш поширений на сьогодні.
116116
117117
Однією з переваг пробілів є те, що пробіли дозволяють більш гнучку конфігурацію відступів, ніж табуляція.
118118
@@ -129,9 +129,9 @@ if (
129129
}
130130
```
131131
132-
- **Вертикальні відступи: пусті рядки для розподілу коду на "логічні блоки" .**
132+
- **Вертикальні відступи: пусті рядки для розподілу коду на "логічні блоки".**
133133
134-
Навіть окрема фунція може бути розподілена на логічні блоки. У наведенному нижче прикладі, ініціалізація змінних, основний цикл та повернення результату розподілені вертикально:
134+
Навіть окрема функція може бути розподілена на логічні блоки. У наведеному нижче прикладі, ініціалізація змінних, основний цикл та повернення результату розподілені вертикально:
135135
136136
```js
137137
function pow(x, n) {
@@ -145,13 +145,13 @@ if (
145145
}
146146
```
147147
148-
Вставляйте додатковий рядок в тому випадку, коли це робить код зрозумілішим. Не повинно бути більше дев'яти рядків коду підряд без вертикального розподілу.
148+
Вставляйте додатковий рядок в тому випадку, коли це робить код зрозумілішим. Не повинно бути понад дев'яти рядків коду підряд без вертикального розподілу.
149149
150150
### Крапка з комою
151151
152152
Крапку з комою треба ставити після кожного виразу, навіть тоді, коли є можливість їх пропустити.
153153
154-
Є мови програмування, у яких крапка з комою є дійсно необов'язковими і рідко використовуються. Проте у JavaScript є ситуації коли перенос строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Більше детально про це знайдете у розділі <info:structure#semicolon>.
154+
Є мови програмування, у яких крапка з комою є дійсно необов'язковими та рідко використовуються. Проте у JavaScript є ситуації коли перенесення строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Більше детально про це знайдете у розділі <info:structure#semicolon>.
155155
156156
Якщо ви досвідчений JavaScript програміст, ви можете обрати стиль коду без крапки з комою, наприклад [StandardJS](https://standardjs.com/). Інакше, краще використовувати крапку з комою для того, щоб уникнути підводних каменів. Більшість розробників використовують крапку з комою.
157157
@@ -281,7 +281,7 @@ function pow(x, n) {
281281
282282
Коли всі члени команди використовують посібник зі стилю, код виглядає однаковим, незалежно від того, хто з команди його написав.
283283
284-
Звичайно, кожна команда може завжди створити свій посібник зі стилю, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш підходящий.
284+
Звичайно, кожна команда може завжди створити свій посібник зі стилю, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш відповідний.
285285
286286
Деякі популярні посібники:
287287
@@ -291,7 +291,7 @@ function pow(x, n) {
291291
- [StandardJS](https://standardjs.com/)
292292
- (і ще багато інших)
293293
294-
Якщо ви початківець, почніть зі шпаргалки наведеної в початку цього розділу. Потім ви зможете обрати один з існуючих посібників, щоб визначити ті правила, які вам більше підходять.
294+
Якщо ви початківець, почніть зі шпаргалки наведеної в початку цього розділу. Потім ви зможете обрати один з чинних посібників, щоб визначити ті правила, які вам більше підходять.
295295
296296
## Автоматичні засоби перевірки (лінтери)
297297
@@ -307,14 +307,14 @@ function pow(x, n) {
307307
308308
Всі вони роблять свою справу. Автор використовує [ESLint](https://eslint.org/).
309309
310-
Більшість лінтерів інтегровані в популярні редактори: просто увімкніть відповідний плаґін в редакторі і налаштуйте стиль.
310+
Більшість лінтерів інтегровані в популярні редактори: просто увімкніть відповідний плагін в редакторі й налаштуйте стиль.
311311
312312
Наприклад, для ESLint вам потрібно зробити наступне:
313313
314314
1. Встановіть [Node.js](https://nodejs.org/).
315315
2. Встановіть ESLint, використовуючи команду `npm install -g eslint` (npm – це менеджер JavaScript пакетів (модулів)).
316316
3. Створіть файл конфігурації `.eslintrc` в корні вашого JavaScript проєкту (у директорії, що містить всі ваші файли).
317-
4. Встановіть/увімкніть плаґін для вашого редактора, який інтегрується з ESLint. Більшість редакторів мають такий плаґін.
317+
4. Встановіть/увімкніть плагін для вашого редактора, який інтегрується з ESLint. Більшість редакторів мають такий плагін.
318318
319319
Ось приклад файлу `.eslintrc`:
320320
@@ -337,12 +337,12 @@ function pow(x, n) {
337337
338338
Крім того, можна завантажити набори правил з мережі та розширити їх. Дивіться <https://eslint.org/docs/user-guide/getting-started> для отримання більш детальної інструкції зі встановлення.
339339
340-
Також, деякі середовища розробки (IDE) мають вбудовані засоби первірки коду, що є зручним, але не таким гнучким в налаштуванні рішенням, як ESLint.
340+
Також, деякі середовища розробки (IDE) мають вбудовані засоби перевірки коду, що є зручним, але не таким гнучким в налаштуванні рішенням, як ESLint.
341341
342342
## Підсумки
343343
344344
Всі правила синтаксису, які описані у даному розділі (і в посиланнях на посібники зі стилю коду) мають на меті поліпшити читабельність вашого коду. Всі вони є дискусійними.
345345
346-
Коли ми прагнемо писати код "краще", ми повинні задати собі наступні питання: "Що робить код більш читабельним та зрозумілим?" і "Що нам допоможе уникнути помилок?". Це головні моменти, що треба брати до уваги, коли ви вибираєте та дискутуєте з приводу стилю коду.
346+
Коли ми прагнемо писати код "краще", ми повинні задати собі наступні питання: "Що робить код більш читабельним та зрозумілим?" і "Що нам допоможе уникнути помилок?". Це головні моменти, що треба брати до уваги, коли ви вибираєте та дискутуєте з приводу стилю коду.
347347
348348
Читання популярних посібників зі стилю коду дозволить вам бути в курсі найкращих практик та останніх ідей щодо стилю коду.

0 commit comments

Comments
 (0)