From 89058e0c86f6aa29f1e5ef76577467e9b4a4b04e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Raphael=20H=C3=B6ser?= <raphael@hoeser.info>
Date: Wed, 29 Jun 2022 22:44:49 +0200
Subject: [PATCH] 11ty/eleventy#2466 Add documentation for skip in pagination
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The referenced PR adds the skip parameter and this one adds the required documentation.

The "addedin" will probably need to be updated once the referenced PR got merged.

Signed-off-by: Raphael Höser <raphael@hoeser.info>
---
 src/docs/pagination.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/src/docs/pagination.md b/src/docs/pagination.md
index 630d108b23..345daa6e24 100644
--- a/src/docs/pagination.md
+++ b/src/docs/pagination.md
@@ -723,6 +723,38 @@ The above will iterate over a data set containing: `["item1 with a suffix", "ite
 
 You can do anything in this `before` callback. Maybe a custom `.sort()`, `.filter()`, `.map()` to remap the entries, `.slice()` to paginate only a subset of the data, etc!
 
+### Skipping Items {% addedin "2.0.0" %}
+
+Sometimes you might want to skip some of the first items in your data (e.g. because you already show them somewhere else).
+
+{% codetitle "YAML Front Matter", "Syntax" %}
+
+```markdown
+---
+pagination:
+  data: testdata
+  size: 2
+  skip: 1
+testdata:
+  - item1
+  - item2
+  - item3
+  - item4
+  - item5
+---
+```
+
+Paginates to:
+
+{% codetitle "JavaScript Object", "Syntax" %}
+
+```js
+[
+  [ "item2", "item3" ],
+  [ "item4", "item5" ],
+]
+```
+
 ### Order of Operations
 
 If you use more than one of these data set modification features, here’s the order in which they operate:
@@ -730,6 +762,7 @@ If you use more than one of these data set modification features, here’s the o
 * The `before` callback
 * `reverse: true`
 * `filter` entries
+* `skip` entries
 
 ## Add All Pagination Pages to Collections {% addedin "0.8.0" %}