From 405180c8634ae7a8a8a3d8ff390f2edc3e102820 Mon Sep 17 00:00:00 2001
From: PLanCompS <18308236+pdmosses@users.noreply.github.com>
Date: Mon, 28 Sep 2020 16:37:42 +0200
Subject: [PATCH] Reorganise tests

Make the titles of test pages more suggestive.
Refactor the documentation of the tests.
---
 docs/tests/navigation/exclude/0.md            |  4 +--
 docs/tests/navigation/exclude/00.md           |  8 ++---
 docs/tests/navigation/exclude/000.md          | 12 +++----
 docs/tests/navigation/exclude/001.md          | 12 +++----
 docs/tests/navigation/exclude/01.md           |  8 ++---
 docs/tests/navigation/exclude/010.md          | 12 +++----
 docs/tests/navigation/exclude/011.md          | 12 +++----
 docs/tests/navigation/exclude/1.md            |  4 +--
 docs/tests/navigation/exclude/10.md           |  8 ++---
 docs/tests/navigation/exclude/100.md          | 12 +++----
 docs/tests/navigation/exclude/101.md          | 12 +++----
 docs/tests/navigation/exclude/11.md           |  8 ++---
 docs/tests/navigation/exclude/110.md          | 12 +++----
 docs/tests/navigation/exclude/111.md          | 12 +++----
 docs/tests/navigation/exclude/index.md        | 32 +++++++++++--------
 docs/tests/navigation/grandparent/a.md        |  4 +--
 docs/tests/navigation/grandparent/b.md        |  4 +--
 docs/tests/navigation/grandparent/ca.md       |  8 ++---
 docs/tests/navigation/grandparent/cb.md       |  8 ++---
 docs/tests/navigation/grandparent/dca.md      | 12 +++----
 docs/tests/navigation/grandparent/dcb.md      | 12 +++----
 docs/tests/navigation/grandparent/index.md    |  6 ++--
 docs/tests/navigation/order/default/10.md     |  4 +--
 docs/tests/navigation/order/default/2.md      |  4 +--
 docs/tests/navigation/order/default/a.md      |  4 +--
 .../navigation/order/default/aa-lower.md      |  4 +--
 docs/tests/navigation/order/default/aa.md     |  4 +--
 docs/tests/navigation/order/default/index.md  |  2 +-
 docs/tests/navigation/order/floats/-1.1.md    |  4 +--
 docs/tests/navigation/order/floats/0.0.md     |  4 +--
 docs/tests/navigation/order/floats/10.0.md    |  4 +--
 docs/tests/navigation/order/floats/2.2222.md  |  4 +--
 docs/tests/navigation/order/floats/index.md   |  2 +-
 docs/tests/navigation/order/index.md          |  2 ++
 docs/tests/navigation/order/integers/-1.md    |  4 +--
 docs/tests/navigation/order/integers/0.md     |  4 +--
 docs/tests/navigation/order/integers/10.md    |  4 +--
 docs/tests/navigation/order/integers/2.md     |  4 +--
 docs/tests/navigation/order/integers/index.md |  2 +-
 docs/tests/navigation/order/mixture/-1.1.md   |  4 +--
 docs/tests/navigation/order/mixture/-1.md     |  4 +--
 docs/tests/navigation/order/mixture/0.0.md    |  4 +--
 docs/tests/navigation/order/mixture/0.md      |  4 +--
 docs/tests/navigation/order/mixture/10.0.md   |  4 +--
 docs/tests/navigation/order/mixture/10.md     |  4 +--
 docs/tests/navigation/order/mixture/2.2222.md |  4 +--
 docs/tests/navigation/order/mixture/2.md      |  4 +--
 docs/tests/navigation/order/mixture/a.md      |  4 +--
 .../navigation/order/mixture/aa-lower.md      |  4 +--
 docs/tests/navigation/order/mixture/aa.md     |  4 +--
 docs/tests/navigation/order/mixture/index.md  |  2 +-
 docs/tests/navigation/order/strings/10.md     |  4 +--
 docs/tests/navigation/order/strings/2.md      |  4 +--
 docs/tests/navigation/order/strings/a.md      |  4 +--
 .../navigation/order/strings/aa-lower.md      |  4 +--
 docs/tests/navigation/order/strings/aa.md     |  4 +--
 docs/tests/navigation/order/strings/index.md  |  2 +-
 57 files changed, 179 insertions(+), 171 deletions(-)

diff --git a/docs/tests/navigation/exclude/0.md b/docs/tests/navigation/exclude/0.md
index 3e495909..96634dd5 100644
--- a/docs/tests/navigation/exclude/0.md
+++ b/docs/tests/navigation/exclude/0.md
@@ -1,13 +1,13 @@
 ---
 layout: default
-title: "0"
+title: Tests for exclusion 0
 has_children: true
 nav_exclude: true
 ---
 # Tests for exclusion 0
 
 ```yaml
-title: "0"
+title: Tests for exclusion 0
 has_children: true
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/00.md b/docs/tests/navigation/exclude/00.md
index 53530048..44aadd1e 100644
--- a/docs/tests/navigation/exclude/00.md
+++ b/docs/tests/navigation/exclude/00.md
@@ -1,15 +1,15 @@
 ---
 layout: default
-title: "00"
-parent: "0"
+title: Tests for exclusion 00
+parent: Tests for exclusion 0
 has_children: true
 nav_exclude: true
 ---
 # Tests for exclusion 00
 
 ```yaml
-title: "00"
-parent: "0"
+title: Tests for exclusion 00
+parent: Tests for exclusion 0
 has_children: true
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/000.md b/docs/tests/navigation/exclude/000.md
index fa34b830..5846671e 100644
--- a/docs/tests/navigation/exclude/000.md
+++ b/docs/tests/navigation/exclude/000.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "000"
-parent: "00"
-grand_parent: "0"
+title: Tests for exclusion 000
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: true
 ---
 # Tests for exclusion 000
 
 ```yaml
-title: "000"
-parent: "00"
-grand_parent: "0"
+title: Tests for exclusion 000
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/001.md b/docs/tests/navigation/exclude/001.md
index 823cfad8..3afe961f 100644
--- a/docs/tests/navigation/exclude/001.md
+++ b/docs/tests/navigation/exclude/001.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "001"
-parent: "00"
-grand_parent: "0"
+title: Tests for exclusion 001
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: false
 ---
 # Tests for exclusion 001
 
 ```yaml
-title: "001"
-parent: "00"
-grand_parent: "0"
+title: Tests for exclusion 001
+parent: Tests for exclusion 00
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/01.md b/docs/tests/navigation/exclude/01.md
index 499230ec..0855b2cb 100644
--- a/docs/tests/navigation/exclude/01.md
+++ b/docs/tests/navigation/exclude/01.md
@@ -1,15 +1,15 @@
 ---
 layout: default
-title: "01"
-parent: "0"
+title: Tests for exclusion 01
+parent: Tests for exclusion 0
 has_children: true
 nav_exclude: false
 ---
 # Tests for exclusion 01
 
 ```yaml
-title: "01"
-parent: "0"
+title: Tests for exclusion 01
+parent: Tests for exclusion 0
 has_children: true
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/010.md b/docs/tests/navigation/exclude/010.md
index 01f498ea..c9944edf 100644
--- a/docs/tests/navigation/exclude/010.md
+++ b/docs/tests/navigation/exclude/010.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "010"
-parent: "01"
-grand_parent: "0"
+title: Tests for exclusion 010
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: true
 ---
 # Tests for exclusion 010
 
 ```yaml
-title: "010"
-parent: "01"
-grand_parent: "0"
+title: Tests for exclusion 010
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/011.md b/docs/tests/navigation/exclude/011.md
index e1413b33..f8359b44 100644
--- a/docs/tests/navigation/exclude/011.md
+++ b/docs/tests/navigation/exclude/011.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "011"
-parent: "01"
-grand_parent: "0"
+title: Tests for exclusion 011
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: false
 ---
 # Tests for exclusion 011
 
 ```yaml
-title: "011"
-parent: "01"
-grand_parent: "0"
+title: Tests for exclusion 011
+parent: Tests for exclusion 01
+grand_parent: Tests for exclusion 0
 has_children: false
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/1.md b/docs/tests/navigation/exclude/1.md
index 4200f2cc..0b6bff87 100644
--- a/docs/tests/navigation/exclude/1.md
+++ b/docs/tests/navigation/exclude/1.md
@@ -1,13 +1,13 @@
 ---
 layout: default
-title: "1"
+title: Tests for exclusion 1
 has_children: true
 nav_exclude: false
 ---
 # Tests for exclusion 1
 
 ```yaml
-title: "1"
+title: Tests for exclusion 1
 has_children: true
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/10.md b/docs/tests/navigation/exclude/10.md
index c68339e0..624d1159 100644
--- a/docs/tests/navigation/exclude/10.md
+++ b/docs/tests/navigation/exclude/10.md
@@ -1,15 +1,15 @@
 ---
 layout: default
-title: "10"
-parent: "1"
+title: Tests for exclusion 10
+parent: Tests for exclusion 1
 has_children: true
 nav_exclude: true
 ---
 # Tests for exclusion 10
 
 ```yaml
-title: "10"
-parent: "1"
+title: Tests for exclusion 10
+parent: Tests for exclusion 1
 has_children: true
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/100.md b/docs/tests/navigation/exclude/100.md
index 22d144e9..89a80906 100644
--- a/docs/tests/navigation/exclude/100.md
+++ b/docs/tests/navigation/exclude/100.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "100"
-parent: "10"
-grand_parent: "1"
+title: Tests for exclusion 100
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: true
 ---
 # Tests for exclusion 100
 
 ```yaml
-title: "100"
-parent: "10"
-grand_parent: "1"
+title: Tests for exclusion 100
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/101.md b/docs/tests/navigation/exclude/101.md
index 5f4a0ee8..240dac76 100644
--- a/docs/tests/navigation/exclude/101.md
+++ b/docs/tests/navigation/exclude/101.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "101"
-parent: "10"
-grand_parent: "1"
+title: Tests for exclusion 101
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: false
 ---
 # Tests for exclusion 101
 
 ```yaml
-title: "101"
-parent: "10"
-grand_parent: "1"
+title: Tests for exclusion 101
+parent: Tests for exclusion 10
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/11.md b/docs/tests/navigation/exclude/11.md
index 6ec08b3a..04cef636 100644
--- a/docs/tests/navigation/exclude/11.md
+++ b/docs/tests/navigation/exclude/11.md
@@ -1,15 +1,15 @@
 ---
 layout: default
-title: "11"
-parent: "1"
+title: Tests for exclusion 11
+parent: Tests for exclusion 1
 has_children: true
 nav_exclude: false
 ---
 # Tests for exclusion 11
 
 ```yaml
-title: "11"
-parent: "1"
+title: Tests for exclusion 11
+parent: Tests for exclusion 1
 has_children: true
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/110.md b/docs/tests/navigation/exclude/110.md
index a9e86106..7c24237e 100644
--- a/docs/tests/navigation/exclude/110.md
+++ b/docs/tests/navigation/exclude/110.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "110"
-parent: "11"
-grand_parent: "1"
+title: Tests for exclusion 110
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: true
 ---
 # Tests for exclusion 110
 
 ```yaml
-title: "110"
-parent: "11"
-grand_parent: "1"
+title: Tests for exclusion 110
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: true
 ```
diff --git a/docs/tests/navigation/exclude/111.md b/docs/tests/navigation/exclude/111.md
index 524ab895..230b55b8 100644
--- a/docs/tests/navigation/exclude/111.md
+++ b/docs/tests/navigation/exclude/111.md
@@ -1,17 +1,17 @@
 ---
 layout: default
-title: "111"
-parent: "11"
-grand_parent: "1"
+title: Tests for exclusion 111
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: false
 ---
 # Tests for exclusion 111
 
 ```yaml
-title: "111"
-parent: "11"
-grand_parent: "1"
+title: Tests for exclusion 111
+parent: Tests for exclusion 11
+grand_parent: Tests for exclusion 1
 has_children: false
 nav_exclude: false
 ```
diff --git a/docs/tests/navigation/exclude/index.md b/docs/tests/navigation/exclude/index.md
index cdeeaab7..7ea374db 100644
--- a/docs/tests/navigation/exclude/index.md
+++ b/docs/tests/navigation/exclude/index.md
@@ -7,26 +7,30 @@ grand_parent: Tests
 
 # Tests for exclusion Exclusion
 
+Pages excluded from the main navigation can have parents and children. Navigation to and between excluded pages can be supported by the auto-generating list of child pages inserted at the bottom of each page, and by links to parents in the breadcrumbs at the top of each page.
+
+The following tests cover all combinations of excluded and included pages for the top level, child pages, and grandchild pages. The last binary digit in a page title indicates whether the page is included (1) or excluded (0); preceding digits refer to its parent and grandparent.
+
 ## Tests for exclusion Included in main navigation
 
-- ["1"](1/)
-- ["11"](11/)
-- ["111"](111/)
+- [Tests for exclusion 1](1/)
+- [Tests for exclusion 11](11/)
+- [Tests for exclusion 111](111/)
 
 ## Tests for exclusion Included only in child navigation
 
-- ["110"](110/)
-- ["10"](10/)
-- ["101"](101/)
-- ["100"](100/)
+- [Tests for exclusion 110](110/)
+- [Tests for exclusion 10](10/)
+- [Tests for exclusion 101](101/)
+- [Tests for exclusion 100](100/)
 
 ## Tests for exclusion Not included in navigation
 
-- ["0"](0/)
-- ["01"](01/)
-- ["011"](011/)
-- ["010"](010/)
-- ["00"](00/)
-- ["001"](001/)
-- ["000"](000/)
+- [Tests for exclusion 0](0/)
+- [Tests for exclusion 01](01/)
+- [Tests for exclusion 011](011/)
+- [Tests for exclusion 010](010/)
+- [Tests for exclusion 00](00/)
+- [Tests for exclusion 001](001/)
+- [Tests for exclusion 000](000/)
 - ["Untitled"](untitled/)
diff --git a/docs/tests/navigation/grandparent/a.md b/docs/tests/navigation/grandparent/a.md
index 23bed508..b680fe6a 100644
--- a/docs/tests/navigation/grandparent/a.md
+++ b/docs/tests/navigation/grandparent/a.md
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: A
+title: Tests for disambiguation A
 has_children: true
 ---
 
@@ -9,6 +9,6 @@ has_children: true
 A top-level page
 
 ```yaml
-title: A
+title: Tests for disambiguation A
 has_children: true
 ```
diff --git a/docs/tests/navigation/grandparent/b.md b/docs/tests/navigation/grandparent/b.md
index 7973bf0f..23403e8a 100644
--- a/docs/tests/navigation/grandparent/b.md
+++ b/docs/tests/navigation/grandparent/b.md
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: B
+title: Tests for disambiguation B
 has_children: true
 ---
 
@@ -9,6 +9,6 @@ has_children: true
 A top-level page
 
 ```yaml
-title: B
+title: Tests for disambiguation B
 has_children: true
 ```
diff --git a/docs/tests/navigation/grandparent/ca.md b/docs/tests/navigation/grandparent/ca.md
index 525428e1..e645044e 100644
--- a/docs/tests/navigation/grandparent/ca.md
+++ b/docs/tests/navigation/grandparent/ca.md
@@ -1,7 +1,7 @@
 ---
 layout: default
-title: C
-parent: A
+title: Tests for disambiguation C
+parent: Tests for disambiguation A
 has_children: true
 ---
 
@@ -10,7 +10,7 @@ has_children: true
 A child of page A, and parent of page D
 
 ```yaml
-title: C
-parent: A
+title: Tests for disambiguation C
+parent: Tests for disambiguation A
 has_children: true
 ```
diff --git a/docs/tests/navigation/grandparent/cb.md b/docs/tests/navigation/grandparent/cb.md
index 1baa41b8..d15844ff 100644
--- a/docs/tests/navigation/grandparent/cb.md
+++ b/docs/tests/navigation/grandparent/cb.md
@@ -1,7 +1,7 @@
 ---
 layout: default
-title: C
-parent: B
+title: Tests for disambiguation C
+parent: Tests for disambiguation B
 has_children: true
 ---
 
@@ -10,7 +10,7 @@ has_children: true
 A child of page B, and parent of page D
 
 ```yaml
-title: C
-parent: B
+title: Tests for disambiguation C
+parent: Tests for disambiguation B
 has_children: true
 ```
diff --git a/docs/tests/navigation/grandparent/dca.md b/docs/tests/navigation/grandparent/dca.md
index 5ff75847..c01dbbbc 100644
--- a/docs/tests/navigation/grandparent/dca.md
+++ b/docs/tests/navigation/grandparent/dca.md
@@ -1,8 +1,8 @@
 ---
 layout: default
-title: D
-parent: C
-grand_parent: A
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation A
 ---
 
 # D
@@ -10,7 +10,7 @@ grand_parent: A
 A grandchild of page A
 
 ```yaml
-title: D
-parent: C
-grand_parent: A
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation A
 ```
diff --git a/docs/tests/navigation/grandparent/dcb.md b/docs/tests/navigation/grandparent/dcb.md
index 567025d5..f80d83d2 100644
--- a/docs/tests/navigation/grandparent/dcb.md
+++ b/docs/tests/navigation/grandparent/dcb.md
@@ -1,8 +1,8 @@
 ---
 layout: default
-title: D
-parent: C
-grand_parent: B
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation B
 ---
 
 # D
@@ -10,7 +10,7 @@ grand_parent: B
 A grandchild of page B
 
 ```yaml
-title: D
-parent: C
-grand_parent: B
+title: Tests for disambiguation D
+parent: Tests for disambiguation C
+grand_parent: Tests for disambiguation B
 ```
diff --git a/docs/tests/navigation/grandparent/index.md b/docs/tests/navigation/grandparent/index.md
index 980a38b9..3d8f799c 100644
--- a/docs/tests/navigation/grandparent/index.md
+++ b/docs/tests/navigation/grandparent/index.md
@@ -1,11 +1,13 @@
 ---
 layout: default
-title: Parent disambiguation
+title: Disambiguation 
 parent: Navigation
 grand_parent: Tests
 ---
 
-# Parent disambiguation
+# Disambiguation
+
+When different pages with children have the same title, referencing the relevant grandparent in the children disambiguates which page is intended.
 
 - [Page A](a/) has a child [page with title C](ca/), and a grandchild [page with title D](dca/).
 - [Page B](b/) has a child [page with title C](cb/), and a grandchild [page with title D](dcb/).
diff --git a/docs/tests/navigation/order/default/10.md b/docs/tests/navigation/order/default/10.md
index bd6fbb83..7e1d82a7 100644
--- a/docs/tests/navigation/order/default/10.md
+++ b/docs/tests/navigation/order/default/10.md
@@ -2,7 +2,7 @@
 layout: default
 title: "10"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "10"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/default/2.md b/docs/tests/navigation/order/default/2.md
index 5e2792b7..158f49a1 100644
--- a/docs/tests/navigation/order/default/2.md
+++ b/docs/tests/navigation/order/default/2.md
@@ -2,7 +2,7 @@
 layout: default
 title: "2"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "2"
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/default/a.md b/docs/tests/navigation/order/default/a.md
index a122e971..bd7e347f 100644
--- a/docs/tests/navigation/order/default/a.md
+++ b/docs/tests/navigation/order/default/a.md
@@ -2,7 +2,7 @@
 layout: default
 title: A
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: A
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/default/aa-lower.md b/docs/tests/navigation/order/default/aa-lower.md
index 43957d61..295ed08e 100644
--- a/docs/tests/navigation/order/default/aa-lower.md
+++ b/docs/tests/navigation/order/default/aa-lower.md
@@ -2,7 +2,7 @@
 layout: default
 title: aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/default/aa.md b/docs/tests/navigation/order/default/aa.md
index 081bcfc0..f100030e 100644
--- a/docs/tests/navigation/order/default/aa.md
+++ b/docs/tests/navigation/order/default/aa.md
@@ -2,7 +2,7 @@
 layout: default
 title: Aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: Aa
 parent: Default
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/default/index.md b/docs/tests/navigation/order/default/index.md
index 3c9cd8fc..c276bb3e 100644
--- a/docs/tests/navigation/order/default/index.md
+++ b/docs/tests/navigation/order/default/index.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Default
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 1
 has_children: true
 ---
diff --git a/docs/tests/navigation/order/floats/-1.1.md b/docs/tests/navigation/order/floats/-1.1.md
index 3466e76c..ee040c82 100644
--- a/docs/tests/navigation/order/floats/-1.1.md
+++ b/docs/tests/navigation/order/floats/-1.1.md
@@ -3,7 +3,7 @@ layout: default
 title: "-1.1"
 nav_order: -1.1
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1.1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1.1"
 nav_order: -1.1
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/floats/0.0.md b/docs/tests/navigation/order/floats/0.0.md
index 6c545baf..f5e516dd 100644
--- a/docs/tests/navigation/order/floats/0.0.md
+++ b/docs/tests/navigation/order/floats/0.0.md
@@ -3,7 +3,7 @@ layout: default
 title: "0.0"
 nav_order: 0.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0.0"
 nav_order: 0.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/floats/10.0.md b/docs/tests/navigation/order/floats/10.0.md
index fc648c46..797f81d1 100644
--- a/docs/tests/navigation/order/floats/10.0.md
+++ b/docs/tests/navigation/order/floats/10.0.md
@@ -3,7 +3,7 @@ layout: default
 title: "10.0"
 nav_order: 10.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10.0"
 nav_order: 10.0
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/floats/2.2222.md b/docs/tests/navigation/order/floats/2.2222.md
index 8050d7ba..89109469 100644
--- a/docs/tests/navigation/order/floats/2.2222.md
+++ b/docs/tests/navigation/order/floats/2.2222.md
@@ -3,7 +3,7 @@ layout: default
 title: "2.2222"
 nav_order: 2.2222
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2.2222
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2.2222"
 nav_order: 2.2222
 parent: Floats
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/floats/index.md b/docs/tests/navigation/order/floats/index.md
index 145ed502..2846629b 100644
--- a/docs/tests/navigation/order/floats/index.md
+++ b/docs/tests/navigation/order/floats/index.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Floats
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 4
 has_children: true
 ---
diff --git a/docs/tests/navigation/order/index.md b/docs/tests/navigation/order/index.md
index 427cc93c..9dbff4a5 100644
--- a/docs/tests/navigation/order/index.md
+++ b/docs/tests/navigation/order/index.md
@@ -7,6 +7,8 @@ grand_parent: Tests
 
 # Order
 
+The value of `nav_order` can be numbers (integers, floats) and/or strings. The following tests illustrate their effects.
+
 - [Default](default/), using `title` instead of `nav_order` fields.
 - [Strings](strings/), lexicographically ordered, possibly case-insensitively.
 - [Integers](integers/), numerically ordered.
diff --git a/docs/tests/navigation/order/integers/-1.md b/docs/tests/navigation/order/integers/-1.md
index 5b6e2296..8b1444ea 100644
--- a/docs/tests/navigation/order/integers/-1.md
+++ b/docs/tests/navigation/order/integers/-1.md
@@ -3,7 +3,7 @@ layout: default
 title: "-1"
 nav_order: -1
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1"
 nav_order: -1
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/integers/0.md b/docs/tests/navigation/order/integers/0.md
index f97f5993..21b13277 100644
--- a/docs/tests/navigation/order/integers/0.md
+++ b/docs/tests/navigation/order/integers/0.md
@@ -3,7 +3,7 @@ layout: default
 title: "0"
 nav_order: 0
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0"
 nav_order: 0
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/integers/10.md b/docs/tests/navigation/order/integers/10.md
index 181bffb8..41571511 100644
--- a/docs/tests/navigation/order/integers/10.md
+++ b/docs/tests/navigation/order/integers/10.md
@@ -3,7 +3,7 @@ layout: default
 title: "10"
 nav_order: 10
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10"
 nav_order: 10
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/integers/2.md b/docs/tests/navigation/order/integers/2.md
index 51c76c75..2ebb1cab 100644
--- a/docs/tests/navigation/order/integers/2.md
+++ b/docs/tests/navigation/order/integers/2.md
@@ -3,7 +3,7 @@ layout: default
 title: "2"
 nav_order: 2
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2"
 nav_order: 2
 parent: Integers
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/integers/index.md b/docs/tests/navigation/order/integers/index.md
index 093944c1..077cdc56 100644
--- a/docs/tests/navigation/order/integers/index.md
+++ b/docs/tests/navigation/order/integers/index.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Integers
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 3
 has_children: true
 ---
diff --git a/docs/tests/navigation/order/mixture/-1.1.md b/docs/tests/navigation/order/mixture/-1.1.md
index 60b8a603..668d6421 100644
--- a/docs/tests/navigation/order/mixture/-1.1.md
+++ b/docs/tests/navigation/order/mixture/-1.1.md
@@ -3,7 +3,7 @@ layout: default
 title: "-1.1"
 nav_order: -1.1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1.1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1.1"
 nav_order: -1.1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/-1.md b/docs/tests/navigation/order/mixture/-1.md
index 81c247f8..e1c5a126 100644
--- a/docs/tests/navigation/order/mixture/-1.md
+++ b/docs/tests/navigation/order/mixture/-1.md
@@ -3,7 +3,7 @@ layout: default
 title: "-1"
 nav_order: -1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # -1
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "-1"
 nav_order: -1
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/0.0.md b/docs/tests/navigation/order/mixture/0.0.md
index 46ea906d..a2006d8e 100644
--- a/docs/tests/navigation/order/mixture/0.0.md
+++ b/docs/tests/navigation/order/mixture/0.0.md
@@ -3,7 +3,7 @@ layout: default
 title: "0.0"
 nav_order: 0.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0.0"
 nav_order: 0.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/0.md b/docs/tests/navigation/order/mixture/0.md
index 5fb96d81..14f137fe 100644
--- a/docs/tests/navigation/order/mixture/0.md
+++ b/docs/tests/navigation/order/mixture/0.md
@@ -3,7 +3,7 @@ layout: default
 title: "0"
 nav_order: 0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "0"
 nav_order: 0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/10.0.md b/docs/tests/navigation/order/mixture/10.0.md
index 4f137a86..70308a6b 100644
--- a/docs/tests/navigation/order/mixture/10.0.md
+++ b/docs/tests/navigation/order/mixture/10.0.md
@@ -3,7 +3,7 @@ layout: default
 title: "10.0"
 nav_order: 10.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10.0
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10.0"
 nav_order: 10.0
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/10.md b/docs/tests/navigation/order/mixture/10.md
index 03c7c887..542ae3ff 100644
--- a/docs/tests/navigation/order/mixture/10.md
+++ b/docs/tests/navigation/order/mixture/10.md
@@ -2,7 +2,7 @@
 layout: default
 title: "10"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "10"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/2.2222.md b/docs/tests/navigation/order/mixture/2.2222.md
index b8d74fb6..2520d512 100644
--- a/docs/tests/navigation/order/mixture/2.2222.md
+++ b/docs/tests/navigation/order/mixture/2.2222.md
@@ -3,7 +3,7 @@ layout: default
 title: "2.2222"
 nav_order: 2.2222
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2.2222
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2.2222"
 nav_order: 2.2222
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/2.md b/docs/tests/navigation/order/mixture/2.md
index 22e118b5..2ae45535 100644
--- a/docs/tests/navigation/order/mixture/2.md
+++ b/docs/tests/navigation/order/mixture/2.md
@@ -2,7 +2,7 @@
 layout: default
 title: "2"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: "2"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/a.md b/docs/tests/navigation/order/mixture/a.md
index 8d367652..342b05f0 100644
--- a/docs/tests/navigation/order/mixture/a.md
+++ b/docs/tests/navigation/order/mixture/a.md
@@ -2,7 +2,7 @@
 layout: default
 title: A
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -10,5 +10,5 @@ grand_parent: Order
 ```yaml
 title: A
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/aa-lower.md b/docs/tests/navigation/order/mixture/aa-lower.md
index 12a86312..2d639853 100644
--- a/docs/tests/navigation/order/mixture/aa-lower.md
+++ b/docs/tests/navigation/order/mixture/aa-lower.md
@@ -3,7 +3,7 @@ layout: default
 title: aa
 nav_order: "aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: aa
 nav_order: "aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/aa.md b/docs/tests/navigation/order/mixture/aa.md
index d826339c..69cf05f3 100644
--- a/docs/tests/navigation/order/mixture/aa.md
+++ b/docs/tests/navigation/order/mixture/aa.md
@@ -3,7 +3,7 @@ layout: default
 title: Aa
 nav_order: "Aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: Aa
 nav_order: "Aa"
 parent: Mixture
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/mixture/index.md b/docs/tests/navigation/order/mixture/index.md
index 5b254633..24317b23 100644
--- a/docs/tests/navigation/order/mixture/index.md
+++ b/docs/tests/navigation/order/mixture/index.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Mixture
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 5
 has_children: true
 ---
diff --git a/docs/tests/navigation/order/strings/10.md b/docs/tests/navigation/order/strings/10.md
index 4bc8b59f..6c3e480e 100644
--- a/docs/tests/navigation/order/strings/10.md
+++ b/docs/tests/navigation/order/strings/10.md
@@ -3,7 +3,7 @@ layout: default
 title: "10"
 nav_order: "10"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 10
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "10"
 nav_order: "10"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/strings/2.md b/docs/tests/navigation/order/strings/2.md
index be13a98b..0c96c32a 100644
--- a/docs/tests/navigation/order/strings/2.md
+++ b/docs/tests/navigation/order/strings/2.md
@@ -3,7 +3,7 @@ layout: default
 title: "2"
 nav_order: "2"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # 2
@@ -12,5 +12,5 @@ grand_parent: Order
 title: "2"
 nav_order: "2"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/strings/a.md b/docs/tests/navigation/order/strings/a.md
index 71dd447d..ac1f3bd5 100644
--- a/docs/tests/navigation/order/strings/a.md
+++ b/docs/tests/navigation/order/strings/a.md
@@ -3,7 +3,7 @@ layout: default
 title: A
 nav_order: A
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # A
@@ -12,5 +12,5 @@ grand_parent: Order
 title: A
 nav_order: A
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/strings/aa-lower.md b/docs/tests/navigation/order/strings/aa-lower.md
index ea9c10b8..0cbb0b25 100644
--- a/docs/tests/navigation/order/strings/aa-lower.md
+++ b/docs/tests/navigation/order/strings/aa-lower.md
@@ -3,7 +3,7 @@ layout: default
 title: aa
 nav_order: "aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: aa
 nav_order: "aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/strings/aa.md b/docs/tests/navigation/order/strings/aa.md
index 1daeb046..6eaf7a24 100644
--- a/docs/tests/navigation/order/strings/aa.md
+++ b/docs/tests/navigation/order/strings/aa.md
@@ -3,7 +3,7 @@ layout: default
 title: Aa
 nav_order: "Aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ---
 
 # Aa
@@ -12,5 +12,5 @@ grand_parent: Order
 title: Aa
 nav_order: "Aa"
 parent: Strings
-grand_parent: Order
+grand_parent: Tests for order
 ```
diff --git a/docs/tests/navigation/order/strings/index.md b/docs/tests/navigation/order/strings/index.md
index 10d20fad..404e3a86 100644
--- a/docs/tests/navigation/order/strings/index.md
+++ b/docs/tests/navigation/order/strings/index.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Strings
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 2
 has_children: true
 ---
-- 
GitLab