feature-sliced · azinit · Feb 13, 2022 · Feb 1, 2022 · Feb 3, 2022 · Feb 3, 2022
diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/basics.md b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/basics.md
@@ -2,7 +2,7 @@
 sidebar_position: 1
 ---
 
-# Базис
+# Основы
 
 :::caution Предупреждение
 

diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/index.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/index.mdx
@@ -20,8 +20,8 @@ import Row from "@site/src/shared/ui/row/tmpl.mdx"
 import { RocketOutlined, BuildOutlined, SettingOutlined } from "@ant-design/icons";
 
 <Row
-    title="Базис"
-    description="Основы методологии (кратко)"
+    title="Основы"
+    description="Основные понятия методологии (кратко)"
     to="/docs/get-started/basics"
     Icon={SettingOutlined}
 />

diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
@@ -11,52 +11,44 @@ pagination_next: get-started/index
 
 **Feature Sliced Design** — это архитектурная методология для проектирования frontend-проектов. Она нацелена на разделение приложения согласно бизнес-логике и областям ответственности. Методология не привязана к конкретному стеку технологий и применима к любым frontend-проектам.
 
-- Обеспечивает [**понятность, контролируемость и адаптивность**][refs-arch-req] архитектуры
-- Основана на [**проверенных временем**][refs-motivation-why] практиках проектирования и концепциях  
+- Обеспечивает **понятность, контролируемость и адаптивность** архитектуры
+- Основана на **проверенных временем** практиках проектирования и концепциях  
   _SOLID, GRASP, DDD, Separation of Concerns, Vertical Slices, Public API, Isolation._
-- Предлагает разделять проект согласно [**предметной области**][ext-ubiq-lang]
+- Предлагает разделять проект по предметным областям
 
 Текущая версия документации приводит примеры на базе связки JavaScript + React.
 
 ## Основы
 
 ![schema-themed--scheme](/img/visual_schema.jpg)
 
-Термины, обозначенные на схеме, подробно описаны в разделе ["Концепции, Абстракции, Структура"][refs-basics].
+Термины, обозначенные на схеме, подробно описаны в разделе [**Abstractions**][refs-basics--abstractions].
 
-## Мотивация
-
-Обычно, подходы построения архитектуры фронтенда от проекта к проекту [переизобретаются с нуля][refs-motivation], пополняя тем самым ["проектные знания"][refs-knowledge]. При этом, неверно принятые решения зачастую приводят [к проблемам масштабируемости проекта и команды][refs-arch-problems]. Поэтому вместо того, чтобы придумывать и документировать это каждый раз, хочется **обобщить опыт и сформировать рабочую, проверенную и задокументированную методологию** для проектирования архитектуры фронтенда.
-
-## Преимущества
-
-:::info
-
-Здесь и далее, [**модуль**][refs-module] — структурная единица проекта (файл / директория).
-
-:::
+Подобная структура имеет ряд преимуществ:
 
-Методология призвана упростить и стандартизировать декомпозицию логики для больших и долгоживущих проектов. Для этого она вводит ряд [концепций][refs-concepts] и [абстракций][refs-splitting], на которых может базироваться архитектура от проекта к проекту. Отсюда получаем ряд преимуществ:
-
-- **Явная бизнес-логика**  
-  Модули распределяются согласно [области влияния, бизнес-ответственности и техническому назначению][refs-splitting].  
+- **Единообразие**  
+  Код распределяется согласно области влияния (слой), предметной области (слайс) и техническому назначению (сегмент).  
   Благодаря этому архитектура стандартизируется и становится более простой для ознакомления.
 
-- **Адаптация к новым условиям**  
-  Каждый компонент архитектуры имеет свое назначение и не влияет на другие.  
-  Благодаря этому под новые требования можно независимо модифицировать функциональность приложения без непредвиденных последствий.
+- **Контролируемое переиспользование логики**  
+  Каждый компонент архитектуры имеет свое назначение и предсказуемый список зависимостей.  
+  Благодаря этому сохраняется баланс между соблюдением принципа **DRY** и возможностью адаптировать модуль под разные цели.
 
-- **Техдолг и рефакторинг**  
-  Каждый модуль является независимым и самодостаточным.  
-  Благодаря этому можно переписать его с нуля без непредвиденных последствий в других частях проекта.
+- **Устойчивость к изменениям и рефакторингу**  
+  Один модуль не может использовать другой модуль, расположенный на том же слое или на слоях выше.
+  Благодаря этому приложение можно изолированно модифицировать под новые требования без непредвиденных последствий.
 
 - **Масштабирование проекта и команды**  
   Увеличение функциональности ведет к значительно меньшему усложнению проекта, т.к. вся логика распределена изолированно, и это распределение определяется однозначно.  
   Благодаря этому легко вводить новых людей в проект/команду, а также расширять функциональность проекта.
 
-- **Контролируемое переиспользование логики**  
-  Каждый модуль имеет свои ограничения и рекомендации на переиспользуемость согласно [своему слою][refs-splitting--layers].  
-  Благодаря этому сохраняется баланс между соблюдением принципа `DRY` и возможностью адаптировать модуль под разные цели.
+
+## Мотивация
+
+Обычно, подходы построения архитектуры фронтенда от проекта к проекту переизобретаются с нуля, пополняя "проектные знания". При этом неверно принятые решения зачастую приводят к проблемам масштабируемости проекта и команды. Поэтому вместо того, чтобы придумывать и документировать это каждый раз, хочется **обобщить опыт и сформировать рабочую, проверенную и задокументированную методологию** для проектирования архитектуры фронтенда.
+
+В разделе [**Мотивация**][refs-motivation] подробно описаны причины возникновения методологии, а также сравнение с другими подходами.  
+В разделе [**Об архитектуре**][refs-architecture] перечислены типичные проблемы проектов, а также требования к идеальной архитектуре, которых стремится придерживаться Feature Sliced Design.
 
 ## Что дальше?
 
@@ -66,10 +58,10 @@ import Link from "@docusaurus/Link";
 
 <Row
     title="Быстрый старт"
-    description="Быстрое погружение в методологию"
+    description="Тур по основным понятиям и структуре, а также подробный разбор проекта на React"
     to="/docs/get-started"
     Icon={"🚀"}
-    tags={['Основы','Быстрый старт','Мотивация']}
+    tags={['Основы', 'Быстрый старт', 'Мотивация']}
 />
 <Row
     title="Гайды"
@@ -108,34 +100,11 @@ import Link from "@docusaurus/Link";
 />
 <Row
     title="Примеры"
-    description="Примеры проектов, спроектированных с Feature Sliced"
+    description="Примеры проектов, спроектированных по Feature Sliced Design"
     to="/examples"
     Icon={"🛠"}
 />
 
-[refs-getstarted]: /docs/get-started
-[refs-basics]: /docs/get-started/basics
+[refs-basics--abstractions]: /docs/get-started/basics#abstractions
 [refs-motivation]: /docs/get-started/motivation
-[refs-motivation-why]: /docs/get-started/motivation#-почему-не-хватает-существующих-решений
-
-[refs-concepts]: /docs/concepts
-[refs-splitting]: /docs/concepts/app-splitting
-[refs-splitting--layers]: /docs/concepts/app-splitting#group-layers
-[refs-arch-req]: /docs/concepts/architecture#требования
-[refs-arch-problems]: /docs/concepts/architecture#проблемы
-
-[refs-guides]: /docs/guides
-[refs-low-coupling]: /docs/concepts/low-coupling
-[refs-migration-v1]: /docs/guides/migration/from-v1
-[refs-examples]: /docs/guides/examples
-
-[refs-reference]: /docs/reference
-[refs-module]: /docs/reference/glossary#модуль
-[refs-knowledge]: /docs/reference/knowledge-types
-
-[refs-about]: /docs/about
-
-
-[ext-ubiq-lang]: https://thedomaindrivendesign.io/developing-the-ubiquitous-language
-
-
+[refs-architecture]: /docs/concepts/architecture