From 40dd6f3e6cb64a19b3eeb36578c40b1b1f675608 Mon Sep 17 00:00:00 2001
From: Andrey Helldar <helldar@dragon-code.pro>
Date: Sat, 1 Nov 2025 02:25:19 +0300
Subject: [PATCH] Added `split files` documentation

---
 docs/snippets/advanced-element-split.php | 27 ++++++++++++++++++++++
 docs/topics/elements.topic               | 29 ++++++++++++++++++++++++
 2 files changed, 56 insertions(+)
 create mode 100644 docs/snippets/advanced-element-split.php

diff --git a/docs/snippets/advanced-element-split.php b/docs/snippets/advanced-element-split.php
new file mode 100644
index 0000000..ceff439
--- /dev/null
+++ b/docs/snippets/advanced-element-split.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Feeds;
+
+use App\Models\User;
+use DragonCode\LaravelFeed\Feeds\Feed;
+use Illuminate\Database\Eloquent\Builder;
+
+class AttributeFeed extends Feed
+{
+    public function builder(): Builder
+    {
+        return User::query();
+    }
+
+    public function perFile(): int
+    {
+        return 100;
+    }
+
+    public function maxFiles(): int
+    {
+        return 10;
+    }
+}
diff --git a/docs/topics/elements.topic b/docs/topics/elements.topic
index 4e29341..778ec62 100644
--- a/docs/topics/elements.topic
+++ b/docs/topics/elements.topic
@@ -113,4 +113,33 @@
 
         <code-block lang="xml" src="advanced-element-attribute.xml" />
     </chapter>
+
+    <chapter title="Split files" id="split_files">
+        <secondary-label ref="format-xml" />
+        <secondary-label ref="format-rss" />
+        <secondary-label ref="format-json" />
+        <secondary-label ref="format-jsonl" />
+        <secondary-label ref="format-csv" />
+
+        <p>
+            If necessary, you can limit the number of lines output to a file, as well as the number of files themselves.
+            To do this, use the perFile and maxFiles functions.
+        </p>
+
+        <code-block lang="php" src="advanced-element-split.php" include-lines="5-" />
+
+        <p>
+            The methods work independently of each other.
+        </p>
+
+        <p>
+            When splitting, a sequential number will be added to the file names. For example:
+        </p>
+
+        <list>
+            <li>attribute-1.xml</li>
+            <li>attribute-2.xml</li>
+            <li>attribute-3.xml</li>
+        </list>
+    </chapter>
 </topic>