ревью

Author: xcurveballx

1-js/03-code-quality/03-comments/article.md

@@ -158,7 +158,7 @@ function addJuice(container) {
     Комментарии, объясняющие решение, очень важны. Они помогают продолжать разработку в правильном направлении.
 
 В коде есть какие-то тонкости? Где они используются?
-: Если в коде есть что-то неочевидное или нелогичное, то такие места определённо нужно комментировать.
+: Если в коде есть какие-то тонкости и неочевидные вещи, его определённо нужно комментировать.
 
 ## Итого
 
@@ -177,4 +177,4 @@ function addJuice(container) {
 - Которые объясняют, "как работает код" и "что он делает".
 - Используйте их только в тех случаях, когда невозможно сделать настолько простой и самодокументированный код, что он не потребует комментариев.
 
-Автодокументирующие инструменты, такие как JSDoc3, также используют комментарии: они их читают и генерируют HTML-документацию (или документацию в другом формате).
+Средства для генерации документации по коду, такие как JSDoc3, также используют комментарии: они их читают и генерируют HTML-документацию (или документацию в другом формате).