From 2c2fc9d83c99037124ae89b6b4cd7e508476d129 Mon Sep 17 00:00:00 2001
From: DCFApixels <99481254+DCFApixels@users.noreply.github.com>
Date: Fri, 22 Nov 2024 12:14:56 +0800
Subject: [PATCH 1/2] Update README-RU.md

---
 README-RU.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README-RU.md b/README-RU.md
index 5cf9ea4..b2085cb 100644
--- a/README-RU.md
+++ b/README-RU.md
@@ -35,7 +35,7 @@
 
 </br>
 
-Реализация связи сущностей в виде графа, где дугами выступают связывающие сущности.
+Реализация связи сущностей в виде графа. Связывающие ребра графа представлены в виде сущностей, что позволяет создавать отношения вида многие ко многим, а с помощью компонентной композиции можно настраивать вид этих отношений.
 
 > [!WARNING]
 > Проект в стадии разработки. API может меняться.
@@ -71,3 +71,28 @@ https://github.com/DCFApixels/DragonECS-Graphs.git
 </br>
 
 # Инициализация
+Для начала нужно создать граф реализованный классом `EntityGraph`. Графу требуется 2 мира: обычный мир и мир для сущностей-связей. Пример создания `EntityGraph`:
+```c#
+// Обычный мир.
+_world = new EcsDefaultWorld();
+// EcsGraphWorld специальный тип мира для сущностей-связей,
+// но может использоваться любой другой тип мира.
+_graphWorld = new EcsGraphWorld();
+// Создание EntityGraph связывающий эти два мира.
+EntityGraph graph = _world.CreateGraph(_graphWorld);
+
+_pipeline = EcsPipeline.New()
+    // ...
+    // Далее миры и граф можно внедрить в системы.
+    .Inject(_world, _graphWorld, graph)
+    // ...
+    .Build()
+```
+Можно использовать один мир для обычных сущностей и для сущностей связей. 
+```c#
+_world = new EcsDefaultWorld();
+// Создание EntityGraph завязанный на одном мире.
+EntityGraph graph = _world.CreateGraph();
+```
+
+# Сущность-связь

From 10633f0b4991063bf877d0539c9d8cc2bcb23bbc Mon Sep 17 00:00:00 2001
From: Mikhail <99481254+DCFApixels@users.noreply.github.com>
Date: Fri, 22 Nov 2024 13:46:44 +0800
Subject: [PATCH 2/2] Update README-RU.md

---
 README-RU.md | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/README-RU.md b/README-RU.md
index b2085cb..8c91efe 100644
--- a/README-RU.md
+++ b/README-RU.md
@@ -35,7 +35,7 @@
 
 </br>
 
-Реализация связи сущностей в виде графа. Связывающие ребра графа представлены в виде сущностей, что позволяет создавать отношения вида многие ко многим, а с помощью компонентной композиции можно настраивать вид этих отношений.
+Реализация отношений сущностей в виде графа. Связывающие ребра графа представлены в виде сущностей, что позволяет создавать отношения вида многие ко многим, а с помощью компонентной композиции можно настраивать вид этих отношений.
 
 > [!WARNING]
 > Проект в стадии разработки. API может меняться.
@@ -70,7 +70,7 @@ https://github.com/DCFApixels/DragonECS-Graphs.git
 
 </br>
 
-# Инициализация
+# Граф
 Для начала нужно создать граф реализованный классом `EntityGraph`. Графу требуется 2 мира: обычный мир и мир для сущностей-связей. Пример создания `EntityGraph`:
 ```c#
 // Обычный мир.
@@ -88,7 +88,7 @@ _pipeline = EcsPipeline.New()
     // ...
     .Build()
 ```
-Можно использовать один мир для обычных сущностей и для сущностей связей. 
+Можно использовать один мир для обычных сущностей и для сущностей-связей. 
 ```c#
 _world = new EcsDefaultWorld();
 // Создание EntityGraph завязанный на одном мире.
@@ -96,3 +96,33 @@ EntityGraph graph = _world.CreateGraph();
 ```
 
 # Сущность-связь
+
+Как и обычная сущность, но управляется и создается в `EntityGraph` и предназначена для данных об отношении двух сущностей.
+
+> Отношения имеют направление, поэтому чтобы разделять сущности, далее будет использованы понятия: начальная сущность(`Start Entity`) от нее исходит сущность-связъ(`Relation Entity`) к конечной сущности(`End Entity`).
+```
+(Start Entity) ─── (Relation Entity) ──► (End Entity)
+```
+Пример работы с связями:
+```c#
+        // Получаем или создаем новую сущность-связь от сущности `startE` к `endE`.
+        // Сущность создается в мире _graph.GraphWorld и регистрируется в графе.
+        var relE = _graph.GetOrNewRelation(startE, endE);
+
+        // Кроме создания и удаления, в остальном сущности-свящи - это обычные сущности.
+        ref var someCmp = ref _somePool.Add(relE);
+
+        // Вернет true если была создана через EntityGraph.GetOrNewRelation(startE, endE)
+        // и false если через EcsWorld.NewEntity().
+        bool isRelation = _graph.IsRelation(relE);
+
+        // Взять сущность-связь для отношения в обратном направлении, от `endE` к `startE`.
+        _graph.GetOrNewInverseRelation(relE);
+
+        // Удаляем сущность связь.
+        _graph.DelRelation(relE);
+```
+
+# Запрос
+
+