Update newer and older tags

Author: Bloke

tags/newer.md

@@ -21,13 +21,11 @@ tags:
 <txp:newer />
 ~~~
 
-The **newer** tag is both a *single* tag and a *container* tag. The tag should be used in a page after an article tag.
+The **newer** tag is both a *single* tag and a *container* tag. Textpattern will replace this tag with a link to the next list of articles in the sort order. As a single tag it outputs the URL for the next list page. If used as a container, it will wrap the text or tag assigned to the link.
 
-Textpattern will replace this tag with a link to the next list of articles in the sort order. The container tags wrap the text or tag assigned to the link. As a single tag it outputs the URL for the next list page.
+An article list consists of the assigned number of articles set by the [article tag](/tags/article). If there are no articles available having 'Newer' status (articles ranked higher, or later, in the present sort criteria than the article shown at the top of the present list) `<txp:newer />` will not display unless the `showalways` attribute is set. It is normally used in tandem with [older](/tags/older) or [pages](/tags/pages).
 
-An article list consists of the assigned number of articles set by the article tag. If there are no articles available having 'Newer' status (articles ranked higher, or newer, in the present sort criteria than the present top of page article) `<txp:newer />` will not display unless the `showalways` attribute is set to `1`. It is normally seen used in tandem with [older](/tags/older).
-
-Given a `<txp:article limit="5" />` tag on the page in question, `<txp:newer />` will page down five articles at a time from the most oldest post forward in time to the most recently posted article.
+Given a `<txp:article limit="5" />` tag on the page in question, `<txp:newer />` will page up five articles at a time from the oldest post forward in time to the most recently posted article.
 
 Note: This tag is context-sensitive, meaning it will only fetch content from the section or category being viewed.
 {: .alert-block .information}
@@ -36,11 +34,6 @@ Note: This tag is context-sensitive, meaning it will only fetch content from the
 
 Tag will accept the following attributes (**case-sensitive**) as well as the {% include atts-global-link.html %}:
 
-`escape="html"` <span class="footnote warning">v4.3.0+</span>
-: Escape [HTML entities](https://developer.mozilla.org/en-US/docs/Glossary/Entity) such as `<`, `>` and `&`.
-: **Values:** See the [tag escaping](/tags/learning/#tag-escaping) documentation for all possible values.
-: **Default:** `html`.
-
 `rel="text"` <span class="footnote warning">v4.7.0+</span>
 : [HTML rel attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes) to be applied to link.
 : **Default:** unset.
@@ -62,6 +55,12 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 <txp:newer rel="prev">Newer</txp:newer>
 ~~~
 
+or, to render the text in the current site language:
+
+~~~ html
+<txp:newer rel="prev"><txp:text item="newer" /></txp:newer>
+~~~
+
 ### Example 2: Single tag - link with image
 
 ~~~ html

tags/older.md

@@ -21,11 +21,9 @@ tags:
 <txp:older />
 ~~~
 
-The **older** tag is both a *single* tag and a *container* tag. The tag should be used in a page after an article tag.
+The **older** tag is both a *single* tag and a *container* tag. Textpattern will replace this tag with a link to the previous list of articles in the sort order. As a single tag it outputs the URL for the previous list page. If used as a container, it will wrap the text or tag assigned to the link
 
-Textpattern will replace this tag with a link to the previous list of articles in the sort order. The container tags wrap the text or tag assigned to the link. As a single tag it outputs the URL for the previous list page.
-
-An article list consists of the assigned number of articles set by the article tag. If there are no articles available having 'Older' status (articles ranked lower, or later, in the present sort criteria than the present bottom of page article) `<txp:older />` will not display unless the `showalways` attribute is set to `1`. It is normally seen used in tandem with [newer](/tags/newer).
+An article list consists of the assigned number of articles set by the [article tag](/tags/article). If there are no articles available having 'Older' status (articles ranked lower, or earlier, in the present sort criteria than the article shown at the bottom of the present list) `<txp:older />` will not display unless the `showalways` attribute is set. It is normally used in tandem with [newer](/tags/newer) or [pages](/tags/pages).
 
 Given a `<txp:article limit="5" />` tag on the page in question, `<txp:older />` will page down five articles at a time from the most recent post back in time to the oldest.
 
@@ -36,11 +34,6 @@ Note: This tag is context-sensitive, meaning it will only fetch content from the
 
 Tag will accept the following attributes (**case-sensitive**) as well as the {% include atts-global-link.html %}:
 
-`escape="html"` <span class="footnote warning">v4.3.0+</span>
-: Escape [HTML entities](https://developer.mozilla.org/en-US/docs/Glossary/Entity) such as `<`, `>` and `&`.
-: **Values:** See the [tag escaping](/tags/learning/#tag-escaping) documentation for all possible values.
-: **Default:** `html`.
-
 `rel="text"` <span class="footnote warning">v4.7.0+</span>
 : [HTML rel attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes) to be applied to link.
 : **Default:** unset.
@@ -62,6 +55,12 @@ Tag will accept the following attributes (**case-sensitive**) as well as the {%
 <txp:older rel="next">Older</txp:older>
 ~~~
 
+or, to render the text in the current site language:
+
+~~~ html
+<txp:older rel="next"><txp:text item="older" /></txp:older>
+~~~
+
 ### Example 2: Single tag - link with image
 
 ~~~ html