diff --git a/docs/ru/basics/documentation.md b/docs/ru/basics/documentation.md
index 6ed3d00..f392acc 100644
--- a/docs/ru/basics/documentation.md
+++ b/docs/ru/basics/documentation.md
@@ -4,7 +4,7 @@ title: Документирование
 
 # Документирование
 
-Документирование должно помогать понять назначение сущности, а не дублировать её типы или очевидные детали.
+Этот раздел описывает правила документирования кода: когда и как писать комментарии к функциям, компонентам, типам и интерфейсам.
 
 ## Правила
 
diff --git a/docs/ru/basics/typing.md b/docs/ru/basics/typing.md
index 0321603..b4b1f6f 100644
--- a/docs/ru/basics/typing.md
+++ b/docs/ru/basics/typing.md
@@ -4,8 +4,7 @@ title: Типизация
 
 # Типизация
 
-Типизация обязательна для всех публичных интерфейсов, функций и компонентов.
-Цель — предсказуемость, безопасность и автодополнение.
+Этот раздел описывает правила типизации: как типизировать компоненты, функции и работу с `any`/`unknown`.
 
 ## Общие правила