Merge commit '5070ba6c9e6c492deade3c30cfe769b9dbf7151d'

docs/content/en/variables/pages.md

@@ -0,0 +1,30 @@
+---
+title: Pages Methods
+linktitle:
+description: Pages is the core page collection in Hugo and has many useful methods.
+date: 2019-10-20
+categories: [variables and params]
+keywords: [pages]
+draft: false
+menu:
+  docs:
+    title: "methods defined on a page collection"
+    parent: "variables"
+    weight: 21
+weight: 21
+sections_weight: 20
+aliases: [/pages]
+toc: true
+---
+
+Also see [List templates](/templates/lists) for an overview of sort methods.
+
+## .Next PAGE
+
+`.Next` and `.Prev` on `Pages` work similar to the methods with the same names on `.Page`, but are more flexible (and slightly slower) as they can be used on any page collection.
+
+`.Next` points **up** to the next page relative to the page sent in as the argument. Example: `{{with .Site.RegularPages.Next . }}{{.RelPermalink}}{{end}}`. Calling `.Next` with the first page in the collection returns `nil`. 
+
+## .Prev PAGE
+
+`.Prev` points **down** to the previous page relative to the page sent in as the argument. Example: `{{with .Site.RegularPages.Prev . }}{{.RelPermalink}}{{end}}`. Calling `.Prev` with the last page in the collection returns `nil`.