Skip to content

Commit 25985d3

Browse files
committed
fixed typos and simplified explanation
*In chapter 03-02 debugging-chrome* Some of sentences were correct, but they were "unnatural" in Ukrainian and make understanding more difficult.
1 parent a62746d commit 25985d3

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

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

+10-10
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) {
@@ -104,7 +104,7 @@ if (
104104
}
105105
```
106106
107-
Максимальну довжину рядка визначається командою. Зазвичай це `80` або `120` символів.
107+
Максимальну довжину рядка слід встановлювати на рівні всієї команди (людської, від слова team). Зазвичай встановлюють `80` або `120` символів.
108108
109109
### Відступи
110110
@@ -151,7 +151,7 @@ if (
151151
152152
Крапку з комою треба ставити після кожного виразу, навіть тоді, коли є можливість їх пропустити.
153153
154-
Є мови програмування, у яких крапка з комою є дійсно необов'язковими та рідко використовуються. Проте у JavaScript є ситуації коли перенесення строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Більше детально про це знайдете у розділі <info:structure#semicolon>.
154+
Є мови програмування, у яких крапка з комою є дійсно необов'язковими та рідко використовуються. Проте у JavaScript є ситуації коли перенесення строки не інтерпретується як крапка з комою, залишаючи код вразливим до помилок. Детальніше про це можна почитати в розділі <info:structure#semicolon>.
155155
156156
Якщо ви досвідчений JavaScript програміст, ви можете обрати стиль коду без крапки з комою, наприклад [StandardJS](https://standardjs.com/). Інакше, краще використовувати крапку з комою для того, щоб уникнути підводних каменів. Більшість розробників використовують крапку з комою.
157157
@@ -180,7 +180,7 @@ for (let i = 0; i < 10; i++) {
180180
}
181181
```
182182
183-
Схожим чином ми можемо змінити `if/else` та `return`.
183+
Схожим чином ми можемо змінити `if`/`else` та `return`.
184184
185185
Наприклад, дві конструкції нижче є ідентичними.
186186
@@ -275,13 +275,13 @@ function pow(x, n) {
275275
276276
Причиною цього є те, що коли ми читаємо код, перш за все ми хочемо зрозуміти *що він робить*. Якщо головний код іде першим - це стає зрозумілим з самого початку. Тоді, можливо ми навіть не будемо читати функції взагалі, особливо якщо їх імена відповідають тому, що вони роблять.
277277
278-
## Посібники зі Стилю Коду
278+
## Style Guide (Посібник зі Стилю Коду)
279279
280-
Посібник зі стилю коду містить загальні правила "як писати" код, наприклад, які лапки використовувати, скільки пробілів ставити для відступу, максимальну довжину рядка, і таке інше. Тобто, багато дрібниць.
280+
Style Guide містить загальні правила "як писати" код. Наприклад які лапки використовувати, скільки пробілів ставити для відступу, максимальну довжину рядка, і таке інше. Тобто, багато дрібниць.
281281
282-
Коли всі члени команди використовують посібник зі стилю, код виглядає однаковим, незалежно від того, хто з команди його написав.
282+
Коли всі члени команди використовують однаковий style guide, код виглядає однаковим, незалежно від того, хто з команди його написав.
283283
284-
Звичайно, кожна команда може завжди створити свій посібник зі стилю, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш відповідний.
284+
Звичайно, кожна команда може завжди створити свій style guide, але зазвичай в цьому не має потреби. Є багато посібників, серед яких можна вибрати найбільш відповідний.
285285
286286
Деякі популярні посібники:
287287
@@ -313,7 +313,7 @@ function pow(x, n) {
313313
314314
1. Встановіть [Node.js](https://nodejs.org/).
315315
2. Встановіть ESLint, використовуючи команду `npm install -g eslint` (npm – це менеджер JavaScript пакетів (модулів)).
316-
3. Створіть файл конфігурації `.eslintrc` в корні вашого JavaScript проєкту (у директорії, що містить всі ваші файли).
316+
3. Створіть файл конфігурації `.eslintrc` в корені вашого JavaScript проєкту (у директорії, що містить всі ваші файли).
317317
4. Встановіть/увімкніть плагін для вашого редактора, який інтегрується з ESLint. Більшість редакторів мають такий плагін.
318318
319319
Ось приклад файлу `.eslintrc`:

0 commit comments

Comments
 (0)