diff --git a/documentation/content/ru/books/handbook/introduction/_index.adoc b/documentation/content/ru/books/handbook/introduction/_index.adoc
--- a/documentation/content/ru/books/handbook/introduction/_index.adoc
+++ b/documentation/content/ru/books/handbook/introduction/_index.adoc
@@ -1,14 +1,14 @@
 ---
-description: 'В этой главе рассматриваются различные аспекты проекта FreeBSD, такие как его история, цели, модель разработки и так далее'
-next: books/handbook/bsdinstall
-params:
-  path: /books/handbook/introduction/
-part: 'В начале'
+title: Глава 1. Введение
+part: Часть I. Начало работы
 prev: books/handbook/parti
-showBookMenu: 'true'
-tags: ["introduction", "synopsis", "about", "Who Uses FreeBSD", "goals", "history"]
-title: 'Глава 1. Введение'
+next: books/handbook/bsdinstall
+description: В этой главе рассматриваются различные аспекты Проекта FreeBSD, такие как его история, цели, модель разработки и так далее
+tags: ["введение", "краткое содержание", "о системе", "кто использует FreeBSD", "цели", "история"]
+showBookMenu: true
 weight: 3
+params:
+  path: "/books/handbook/introduction/"
 ---
 
 [[introduction]]
@@ -63,7 +63,7 @@
 * Откуда произошло название «FreeBSD».
 
 [[nutshell]]
-== Добро пожаловать в FreeBSD!
+== Добро пожаловать во FreeBSD!
 
 FreeBSD — это операционная система с открытым исходным кодом, соответствующая стандартам и похожая на Unix, предназначенная для компьютеров на архитектурах x86 (как 32-, так и 64-битных), ARM, AArch64, RISC-V, POWER и PowerPC. Она предоставляет все функции, которые сегодня считаются само собой разумеющимися, такие как вытесняющая многозадачность, защита памяти, виртуальная память, многопользовательские возможности, поддержка SMP, все инструменты разработки с открытым исходным кодом для различных языков и фреймворков, а также возможности для рабочих станций, включая X Window System, KDE или GNOME. Её основные преимущества:
 
@@ -73,7 +73,7 @@
 * _Расширенные функции безопасности_, от системы принудительного контроля доступа до механизмов песочницы и возможностей Capsicum.
 * _Более 30 тысяч предварительно собранных пакетов_ для всех поддерживаемых архитектур, а также Коллекция портов, которая позволяет легко создавать собственные настраиваемые пакеты.
 * _Документация_ - в дополнение к Руководству и книгам различных авторов, охватывающим темы от системного администрирования до внутреннего устройства ядра, существуют также man:man[1] страницы, доступные не только для пользовательских демонов, утилит и конфигурационных файлов, но и для API драйверов ядра (раздел 9) и отдельных драйверов (раздел 4).
-* _Простая и последовательная структура репозитория и система сборки_ - FreeBSD использует единый репозиторий для всех своих компонентов, как ядра, так и пользовательского пространства. Это, наряду с унифицированной и легко настраиваемой системой сборки, а также продуманным процессом разработки, позволяет легко интегрировать FreeBSD в инфраструктуру сборки вашего продукта.
+* _Простая и целостная структура хранилища исходного кода и система сборки_ - FreeBSD использует единый репозиторий для всех своих компонентов, как относящихся к ядру, так и пользовательскому окружению. Вместе с унифицированной, легко настраиваемой системой сборки и хорошо продуманным процессом разработки это позволяет легко интегрировать FreeBSD в инфраструктуру сборки решений сторонних разработчиков или производных продуктов.
 * _Верность философии Unix_, предпочитая модульность вместо монолитных "всё в одном" демонов с жёстко заданным поведением.
 * _Двоичная совместимость_ с Linux, позволяющая запускать многие Linux-приложения без необходимости виртуализации.
 
@@ -204,3 +204,9 @@
 Актуальную документацию всегда можно найти на link:https://docs.FreeBSD.org/[Портале документации].
 
 Все товарные знаки являются собственностью их законных владельцев.
+
+//
+// The FreeBSD Russian Documentation Project
+//
+// Original EN revision (18.12.2025): 2fd56ac7e0891ff0c99ef315ccb6662bde78f93f
+//