Small fix docs

ru/01_Общая информация/index.md

@@ -1,3 +1,34 @@
-В этом разделе содержится общая информация о Evolution CMS. В основном она будет полезна тем, кто только начинает свое знакомство с этой CMS. Хотя и для специалистов здесь найдется много интересного.
+Раздел содержит общую информацию обо всём, что связано с Evolution CE, и что вам необходимо знать перед началом работы с системой.
 
-Если вы хотите разобраться в том, что вам может предложить EVO, то рекомендуем вам читать все в том порядке, который существует. Если возникли какие-то вопросы или материал показался вам недостаточно раскрытым, то лучше всего обратиться в сообщество. На основе ваших вопросов мы постоянно улучшаем наши материалы, а значит их качество зависит от вас.
+## Ключевые преимущества
+
+### 1. Простота освоения и управления
+Для ежедневного управления сайтом не требуются специальные технические навыки. За 20 лет развития процессы администрирования (публикация материалов, редактирование меню, настройка пользователей) были доведены до интуитивно понятного уровня.
+
+### 2. Высокая скорость работы и отзывчивость
+Архитектура системы и постоянные оптимизации обеспечивают быструю загрузку страниц. Внесение изменений в структуру сайта или контент происходит практически мгновенно, что экономит время администраторов.
+
+### 3. Свобода в разработке и дизайне
+Система **не навязывает свой HTML-код**. Вы можете использовать любой фронтенд-фреймворк, любой шаблонизатор или чистый HTML. Evolution CE работает с вашей вёрсткой, а не наоборот.
+
+### 4. Мощная и гибкая система шаблонов*
+Шаблоны, чанки (повторяющиеся элементы) и сниппеты (кусочки PHP-логики) позволяют создавать сложные динамические страницы без дублирования кода. Изменение в одном месте применяется ко всему сайту.
+
+### 5. Активное сообщество и открытый код
+Будучи open-source проектом, Evolution CE развивается силами сообщества. У вас есть доступ ко всей кодовой базе, возможность вносить изменения и получать поддержку от других разработчиков.
+
+## Архитектура: гибкость и эволюция
+
+Базовый принцип Evolution — разделение данных, логики и представления. Этот подход позволяет легко поддерживать и развивать сайт.
+
+**В современной Evolution 3.x это реализовано с помощью мощного стека:**
+1.  **Уровень данных (Модель):** Используется ORM **Eloquent** от Laravel для удобной и безопасной работы с документами, настройками и любыми вашими таблицами.
+2.  **Уровень логики (Контроллер):** Логику страниц можно описывать в классах-контроллерах (подход Laravel) или традиционным способом — в сниппетах. Выбор за вами.
+3.  **Уровень представления (Вид):** Для вёрстки доступен мощный шаблонизатор **Blade**, а также привычные **чанки**. Можно использовать их вместе.
+
+> **Важно:** Evolution 3.x **полностью сохраняет** возможность работать в классическом стиле 1.4.x (через сниппеты и чанки). Это позволяет переносить старые проекты и использовать проверенные решения.
+
+> **Важно!** Если у вас возникли вопросы или какой-то материал кажется недостаточно раскрытым, обратитесь к сообществу Evolution CMS в [Телеграм](https://t.me/evo_cms). На основе ваших вопросов и обратной связи мы постоянно улучшаем документацию — её качество зависит от вас!
+
+---
+*- Информация актуальна для всех версий Evolution CE, но ориентирована на версию 1.4.х

ru/index.md

@@ -1,7 +1,16 @@
 # Документация по Evolution CMS
 
-*Evolution CMS — это профессиональный инструмент разработки сайтов, позволяющий управлять контентом (да и самим сайтом) абсолютно на все 100%! Эта система с открытым кодом (open source), и поэтому бесплатна. В отличие от большинства бесплатных CMS, на Evolution вы можете построить сайт любой сложности, практически с любым набором функций, при этом система не будет никоим образом влиять на ваш html-код.*
+*Evolution CE (Community Edition) — это современная, гибкая система управления контентом с открытым исходным кодом, унаследовавшая лучшее от MODX Evolution и дополненная современными подходами к разработке. Её ключевая философия — **не мешать разработчику, давая ему полную свободу** в создании контента, дизайна и логики сайта.*
 
+Этот репозиторий содержит исходный код документации, которая публикуется на [документационном сайте Evolution CMS](https://docs.evocms.ru/). Мы приветствуем вашу помощь в её улучшении!
+
+## С чего начать?
+
+Перед стартом вам необходимо определиться, какая ветка системы вам больше подходит:
+
+**Версия 3** - актуальная версия системы с использованием компонентов Laravel. В ней улучшена работа с пользователями. Evolution CMS 3 позволяет разрабатывать сайты быстрее и удобнее, используя GIT, Composer, шаблонизатор Blade и многие другие возможности Laravel. При этом можно по-прежнему делать сайты, используя привычные со времен MODX чанки и сниппеты.
+
+**Версия 1.4** - это классическая версия, прямой потомок MODX Evolution. Популярна благодаря невысоким требованиям к хостингу. Её развитие прекращено, поддержка со стороны разработчиков минимальна. Версию 1.4 используют для обновления старых сайтов, чтобы они работали с современными версиями PHP.
 
 ## Как внести свой вклад
 1. Для начала у вас должен быть аккаунт на GitHub, если нет - [то его сделать очень просто](https://github.com/join).