Feb 16, 2025
diff --git a/1-js/03-code-quality/03-comments/article.md b/1-js/03-code-quality/03-comments/article.md
 Тож, пояснювальні коментарі зазвичай погані. Які ж тоді хороші?

 Описуйте архітектуру
 : Додавайте опис компонентів вищого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду звисоту пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.
 : Додавайте опис компонентів вищого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду звисоти пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.

 Документуйте параметри функції та її використання
 : Існує спеціальний синтаксис [JSDoc](https://uk.wikipedia.org/wiki/JSDoc) для документації функції: її використання, параметри, значення, що повертає.
 **Уникайте коментарі:**

 - Які описують, як код працює і що він робить.
 - Пишіть їх тільки у тому випадку, колине має змоги написати простий та самоописний код, якому пояснення не потрібні.
 - Пишіть їх тільки у тому випадку, колинемає змоги написати простий та самоописний код, якому пояснення не потрібні.

 Коментарі також використовуються інструментами для автоматичної генерації документації, наприклад JSDoc3 - вони читають їх та генерують HTML-документи (або документи в іншому форматі).
Original file line number	Diff line number	Diff line change
Expand Up		@@ -120,7 +120,7 @@ function addJuice(container) {
		Тож, пояснювальні коментарі зазвичай погані. Які ж тоді хороші?

		Описуйте архітектуру
		: Додавайте опис компонентів вищого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду звисоту пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.
		: Додавайте опис компонентів вищого рівня, як вони взаємодіють, який потік управління мають у різних обставинах... Якщо коротко - огляд коду звисоти пташиного польоту. Є спеціальна мова [UML](https://uk.wikipedia.org/wiki/Unified_Modeling_Language) для побудови діаграм високорівневої архітектури коду. Її однозначно варто вчити.

		Документуйте параметри функції та її використання
		: Існує спеціальний синтаксис [JSDoc](https://uk.wikipedia.org/wiki/JSDoc) для документації функції: її використання, параметри, значення, що повертає.
Expand DownExpand Up		@@ -175,6 +175,6 @@ function pow(x, n) {
		Уникайте коментарі:

		- Які описують, як код працює і що він робить.
		- Пишіть їх тільки у тому випадку, колине має змоги написати простий та самоописний код, якому пояснення не потрібні.
		- Пишіть їх тільки у тому випадку, колинемає змоги написати простий та самоописний код, якому пояснення не потрібні.

		Коментарі також використовуються інструментами для автоматичної генерації документації, наприклад JSDoc3 - вони читають їх та генерують HTML-документи (або документи в іншому форматі).