Reorganise tests

Make the titles of test pages more suggestive.
Refactor the documentation of the tests.

docs/tests/navigation/grandparent/dcb.md

 ---
 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
 ```

docs/tests/navigation/grandparent/index.md

 ---
 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/).

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
 ```

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
 ```

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
 ```

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
 ```

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
 ```

docs/tests/navigation/order/default/index.md

 ---
 layout: default
 title: Default
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 1
 has_children: true
 ---

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
 ```

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
 ```

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
 ```

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
 ```

docs/tests/navigation/order/floats/index.md

 ---
 layout: default
 title: Floats
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 4
 has_children: true
 ---

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.

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
 ```

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
 ```

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
 ```

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
 ```

docs/tests/navigation/order/integers/index.md

 ---
 layout: default
 title: Integers
-parent: Tests for navigation order
+parent: Tests for order
 nav_order: 3
 has_children: true
 ---

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
 ```