diff --git a/README.md b/README.md
index 4d1ea8e..a0185c3 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,36 @@
-### rubnav
+# Модуль «Навигация по рубрике» (RubNav)
 
-## Модуль Навигация по документам рубрики v3.31
+**Версия:** 3.31  
+**Совместимость:** AVE.cms Alt v3.31 и выше  
+**Категория:** Навигация / Интерфейс  
 
+---
 
-### Навигация по документам в пределах рубрики (следущая-предыдущая)
+### 📋 Описание
+Модуль позволяет организовать удобную навигацию между документами (ссылки «Следующий» и «Предыдущий») строго в пределах одной текущей рубрики. 
 
- * Инструкция:<br />[mod_rubnav:next] - следущая<br />[mod_rubnav:prev] - предыдущая
+---
 
+### 🚀 Использование (Системные теги)
 
-### Перед копированием модуля в папку modules, удалите файл README.md, копируйте только корневую папку rubnav со всем ее содержимым внутри!
+Для вывода ссылок навигации разместите следующие теги (например в шаблоне рубрики) :
 
-### Changelog:
+- `[mod_rubnav:next]` — выводит ссылку на **следующий** (более новый) документ.
+- `[mod_rubnav:prev]` — выводит ссылку на **предыдущий** (более старый) документ.
 
-07.05.2026 - версия 3.31 - адаптация для версии ave.cms alt v3.31 и выше
+---
 
-03.09.2019 - версия 1.26.2 - адаптация для версии ave.cms 3.26
+### 🛠 Особенности версии 3.31
+* **Двухфакторная сортировка**: Выборка идет по связке `document_published` + `Id`, что гарантирует уникальность ссылок.
+* **Оптимизация под PHP 8.1+**: Исправлены ошибки конструкторов классов и типизации.
 
-05.05.2014 - версия 1.1.2
\ No newline at end of file
+---
+
+### 🔧 Настройка шаблона
+В панели управления модулем вы можете использовать следующие внутренние теги для формирования вида ссылок:
+- `[tag:link]` — URL-адрес документа.
+- `[tag:linkname]` — Название (заголовок) документа.
+
+**Пример шаблона в админке модуля:**
+```html
+<a href="[tag:link]" class="next-doc-link">Вперед: [tag:linkname] →</a>
\ No newline at end of file