самодокументированный

Author: xcurveballx

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

@@ -65,7 +65,7 @@ function isPrime(n) {
 }
 ```
 
-Теперь мы можем легко понять код. Функция сама становится комментарием. Такой код называется *самодокументируемым*.
+Теперь мы можем легко понять код. Функция сама становится комментарием. Такой код называется *самодокументированным*.
 
 ### Рецепт: создавайте функции
 
@@ -113,7 +113,7 @@ function addJuice(container) {
 
 Ещё раз, функции сами по себе описывают, что в них происходит. Тут нечего комментировать. И ещё, структура кода лучше, когда она разделена на части. Понятно, что делает каждая функция, что она принимает и что возвращает.
 
-В реальности мы не можем полностью избежать "объясняющих" комментариев. Существуют сложные алгоритмы. И есть хитрые уловки для оптимизации. Но в целом мы должны стараться писать простой и самодокументируемый код.
+В реальности мы не можем полностью избежать "объясняющих" комментариев. Существуют сложные алгоритмы. И есть хитрые уловки для оптимизации. Но в целом мы должны стараться писать простой и самодокументированный код.
 
 ## Хорошие комментарии
 
@@ -175,6 +175,6 @@ function addJuice(container) {
 **Избегайте комментариев:**
 
 - Которые объясняют, "как работает код" и "что он делает".
-- Используйте их только в тех случаях, когда невозможно сделать настолько простой и самодокументируемый код, что он не потребует комментариев.
+- Используйте их только в тех случаях, когда невозможно сделать настолько простой и самодокументированный код, что он не потребует комментариев.
 
 Автодокументирующие инструменты, такие как JSDoc3, также используют комментарии: они их читают и генерируют HTML-документацию (или документацию в другом формате).