Add EntityWriter to docs, update translations

Author: samdark

docs/guide/en/README.md

@@ -1,3 +1,4 @@
 # Yii Data Cycle
 
 - [EntityReader class](entity-reader.md)
+- [EntityWriter](entity-writer.md)

docs/guide/en/entity-reader.md

@@ -1,4 +1,4 @@
-# EntityReader Class
+# EntityReader
 
 `EntityReader` allows to securely pass select-queries from repository to user runtime.
 By select-query we assume an instance of `\Cycle\ORM\Select` or `\Cycle\Database\Query\SelectQuery`.

docs/guide/en/entity-writer.md

@@ -0,0 +1,28 @@
+# EntityWriter
+
+`EntityWriter` adapts Cycle ORM's `EntityManagerInterface` to the generic `Yiisoft\Data\Writer\DataWriterInterface`
+so you can persist or delete entities in a uniform way.
+
+Writing and deleting entities could be done in the following way:
+
+```php
+use Cycle\ORM\EntityManagerInterface;
+use Yiisoft\Data\Cycle\Writer\EntityWriter;
+
+final class ArticleRepository
+{
+    public function __construct(
+        private EntityWriter $writer,
+    ) {}
+
+    public function saveAll(iterable $articles): void
+    {
+        $this->writer->write($articles);
+    }
+    
+    public function removeAll(iterable $articles): void
+    {
+        $this->writer->delete($articles);
+    }
+}
+```

docs/guide/es/README.md

@@ -1,3 +1,4 @@
 # Yii Data Cycle
 
-- [Clase EntityReader](entity-reader.md)
+- [EntityReader](entity-reader.md)
+- [EntityWriter](entity-writer.md)

docs/guide/es/entity-reader.md

@@ -1,8 +1,8 @@
-# Clase EntityReader
+# EntityReader
 
 `EntityReader` es una herramienta útil para transferir de forma segura las solicitudes de selección del repositorio en tiempo de ejecución del usuario.
 
-Una solicitud de selección se refiere a una instancia de una de las clases: ``CycleORM\Select`` o ``Spiral\Database\Query\SelectQuery``.
+Una solicitud de selección se refiere a una instancia de una de las clases: `\Cycle\ORM\Select` o `\Cycle\Database\Query\SelectQuery`.
 
 Lo que hay que saber sobre `EntityReader`:
 
@@ -34,6 +34,9 @@ class ArticleRepository extends \Cycle\ORM\Select\Repository
 }
 ```
 
+Utiliza los filtros del paquete [yiisoft/data](https://github.com/yiisoft/data) o cualquier otro, habiendo escrito previamente
+los manejadores (procesadores) apropiados para ellos.
+
 Ahora podemos utilizar `EntityReader` para la paginación como el siguiente ejemplo:
 
 ```php
@@ -112,8 +115,8 @@ foreach ($lastPublicReader->read() as $article) {
 }
 ```
 
-La ordenación a través de `EntityReader` no sustituye la ordenación en la consulta inicial, sino que le añade algo más.
-Si necesitas establecer la ordenación por defecto en un método del repositorio, pero quieres poder cambiarla en un controlador, puedes puede hacerlo de la siguiente manera:
+La ordenación a través de `EntityReader` no sustituye la ordenación en la consulta inicial, sino que la complementa.
+Si necesitas establecer la ordenación por defecto en un método del repositorio, pero quieres poder cambiarla en un controlador, puedes hacerlo de la siguiente manera:
 
 ```php
 use Yiisoft\Data\Cycle\Data\Reader\EntityReader;

docs/guide/es/entity-writer.md

@@ -0,0 +1,28 @@
+# EntityWriter
+
+`EntityWriter` adapta `EntityManagerInterface` de Cycle ORM a la interfaz genérica `Yiisoft\Data\Writer\DataWriterInterface`
+para que puedas persistir o eliminar entidades de manera uniforme.
+
+La escritura y eliminación de entidades puede hacerse de la siguiente manera:
+
+```php
+use Cycle\ORM\EntityManagerInterface;
+use Yiisoft\Data\Cycle\Writer\EntityWriter;
+
+final class ArticleRepository
+{
+    public function __construct(
+        private EntityWriter $writer,
+    ) {}
+
+    public function saveAll(iterable $articles): void
+    {
+        $this->writer->write($articles);
+    }
+    
+    public function removeAll(iterable $articles): void
+    {
+        $this->writer->delete($articles);
+    }
+}
+```

docs/guide/pt-BR/README.md

@@ -1,3 +1,4 @@
 # Yii Data Cycle
 
-- [Classe EntityReader](entity-reader.md)
+- [EntityReader](entity-reader.md)
+- [EntityWriter](entity-writer.md)

docs/guide/pt-BR/entity-reader.md

@@ -1,4 +1,4 @@
-# Classe EntityReader
+# EntityReader
 
 `EntityReader` permite passar com segurança consultas de seleção do repositório para o tempo de execução do usuário.
 Por consulta selecionada, assumimos uma instância de `\Cycle\ORM\Select` ou `\Cycle\Database\Query\SelectQuery`.

docs/guide/pt-BR/entity-writer.md

@@ -0,0 +1,28 @@
+# EntityWriter
+
+`EntityWriter` adapta o `EntityManagerInterface` do Cycle ORM à interface genérica `Yiisoft\Data\Writer\DataWriterInterface`
+para que você possa persistir ou excluir entidades de forma uniforme.
+
+A escrita e a exclusão de entidades podem ser feitas da seguinte forma:
+
+```php
+use Cycle\ORM\EntityManagerInterface;
+use Yiisoft\Data\Cycle\Writer\EntityWriter;
+
+final class ArticleRepository
+{
+    public function __construct(
+        private EntityWriter $writer,
+    ) {}
+
+    public function saveAll(iterable $articles): void
+    {
+        $this->writer->write($articles);
+    }
+    
+    public function removeAll(iterable $articles): void
+    {
+        $this->writer->delete($articles);
+    }
+}
+```

docs/guide/ru/README.md

@@ -1,3 +1,4 @@
 # Yii Data Cycle
 
-- [Класс EntityReader](entity-reader.md)
+- [EntityReader](entity-reader.md)
+- [EntityWriter](entity-writer.md)