[PATCH] Documentation: adopt a consistent nav_order format

[PATCH] Documentation: adopt a consistent nav_order format

[Alyssa Ross]

Previously, inserting a new page in the middle of the nav_order would
require moving all later pages, and we were relying on the
default (alphabetical?) ordering to break ties.

Give every current page a round hundred nav_order.  That way, we have
no ties (except for unnumbered pages, that get listed last, and where
the order between them doesn't matter to us), and it's easy to insert
new pages in future without renumbering all later ones.

Signed-off-by: Alyssa Ross <hi@alyssa.is>
---
 Documentation/bibliography.html                            | 2 +-
 Documentation/design.html                                  | 2 +-
 Documentation/doc/about/index.adoc                         | 2 +-
 Documentation/doc/contributing/b4.adoc                     | 2 +-
 Documentation/doc/contributing/building-documentation.adoc | 2 +-
 Documentation/doc/contributing/communication.adoc          | 2 +-
 Documentation/doc/contributing/first-patch.adoc            | 2 +-
 Documentation/doc/contributing/index.adoc                  | 2 +-
 Documentation/doc/contributing/replying.adoc               | 2 +-
 Documentation/doc/contributing/reviewing-patches.adoc      | 2 +-
 Documentation/doc/contributing/testing-patches.adoc        | 2 +-
 Documentation/doc/contributing/working-with-patches.adoc   | 2 +-
 Documentation/doc/contributing/writing_documentation.adoc  | 2 +-
 Documentation/doc/development/index.adoc                   | 2 +-
 Documentation/doc/index.adoc                               | 2 +-
 Documentation/doc/installation/index.adoc                  | 2 +-
 Documentation/doc/using-spectrum/index.adoc                | 2 +-
 Documentation/index.html                                   | 2 +-
 Documentation/logo/index.html                              | 2 +-
 Documentation/motivation.html                              | 2 +-
 Documentation/software/index.html                          | 2 +-
 21 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/Documentation/bibliography.html b/Documentation/bibliography.html
index 175115ad..c4321861 100644
--- a/Documentation/bibliography.html
+++ b/Documentation/bibliography.html
@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Bibliography
-nav_order: 200
+nav_order: 600
 ---
 <!-- SPDX-FileCopyrightText: 2019-2023 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later -->
diff --git a/Documentation/design.html b/Documentation/design.html
index 0aa8762c..e01366bb 100644
--- a/Documentation/design.html
+++ b/Documentation/design.html
@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Design
-nav_order: 2
+nav_order: 300
 ---
 <!-- SPDX-FileCopyrightText: 2019-2020, 2022, 2024 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later -->
diff --git a/Documentation/doc/about/index.adoc b/Documentation/doc/about/index.adoc
index 019737f1..cfeedb8d 100644
--- a/Documentation/doc/about/index.adoc
+++ b/Documentation/doc/about/index.adoc
@@ -1,5 +1,5 @@
 = About Spectrum
-:page-nav_order: 1
+:page-nav_order: 100
 
 // SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/b4.adoc b/Documentation/doc/contributing/b4.adoc
index cc120180..ef974726 100644
--- a/Documentation/doc/contributing/b4.adoc
+++ b/Documentation/doc/contributing/b4.adoc
@@ -1,5 +1,5 @@
 = Installing and Configuring b4
-:page-nav_order: 3
+:page-nav_order: 600
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/building-documentation.adoc b/Documentation/doc/contributing/building-documentation.adoc
index b691d4d2..a8b9a60a 100644
--- a/Documentation/doc/contributing/building-documentation.adoc
+++ b/Documentation/doc/contributing/building-documentation.adoc
@@ -1,5 +1,5 @@
 = Building Documentation
-:page-nav_order: 4
+:page-nav_order: 900
 
 // SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/communication.adoc b/Documentation/doc/contributing/communication.adoc
index 1b6d4d2f..89a2f811 100644
--- a/Documentation/doc/contributing/communication.adoc
+++ b/Documentation/doc/contributing/communication.adoc
@@ -1,5 +1,5 @@
 = Communication channels
-:page-nav_order: 1
+:page-nav_order: 100
 
 // SPDX-FileCopyrightText: 2019-2024 Alyssa Ross <hi@alyssa.is>
 // SPDX-FileCopyrightText: 2023 Unikie
diff --git a/Documentation/doc/contributing/first-patch.adoc b/Documentation/doc/contributing/first-patch.adoc
index 2625888b..d46fbdab 100644
--- a/Documentation/doc/contributing/first-patch.adoc
+++ b/Documentation/doc/contributing/first-patch.adoc
@@ -1,5 +1,5 @@
 = Sending Your Patch
-:page-nav_order: 1
+:page-nav_order: 200
 
 // SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/index.adoc b/Documentation/doc/contributing/index.adoc
index c34f4c1d..b40907b3 100644
--- a/Documentation/doc/contributing/index.adoc
+++ b/Documentation/doc/contributing/index.adoc
@@ -1,5 +1,5 @@
 = Contributing
-:page-nav_order: 5
+:page-nav_order: 500
 :page-redirect_from: ["/contributing.html"]
 
 // SPDX-FileCopyrightText: 2023 Unikie
diff --git a/Documentation/doc/contributing/replying.adoc b/Documentation/doc/contributing/replying.adoc
index c6ec4b87..c917bc33 100644
--- a/Documentation/doc/contributing/replying.adoc
+++ b/Documentation/doc/contributing/replying.adoc
@@ -1,5 +1,5 @@
 = Replying to Messages in the Mailing List Archives
-:page-nav_order: 3
+:page-nav_order: 700
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/reviewing-patches.adoc b/Documentation/doc/contributing/reviewing-patches.adoc
index 224e314b..df3b1f97 100644
--- a/Documentation/doc/contributing/reviewing-patches.adoc
+++ b/Documentation/doc/contributing/reviewing-patches.adoc
@@ -1,5 +1,5 @@
 = Reviewing Patches
-:page-nav_order: 2
+:page-nav_order: 300
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/contributing/testing-patches.adoc b/Documentation/doc/contributing/testing-patches.adoc
index 031855d5..15451044 100644
--- a/Documentation/doc/contributing/testing-patches.adoc
+++ b/Documentation/doc/contributing/testing-patches.adoc
@@ -1,5 +1,5 @@
 = Testing Patches
-:page-nav_order: 2
+:page-nav_order: 400
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 // SPDX-FileCopyrightText: 2022 Unikie
diff --git a/Documentation/doc/contributing/working-with-patches.adoc b/Documentation/doc/contributing/working-with-patches.adoc
index 6e1e83ee..4e957253 100644
--- a/Documentation/doc/contributing/working-with-patches.adoc
+++ b/Documentation/doc/contributing/working-with-patches.adoc
@@ -1,5 +1,5 @@
 = Working with Patches
-:page-nav_order: 2
+:page-nav_order: 500
 
 // SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-FileCopyrightText: 2025 Alyssa Ross <hi@alyssa.is>
diff --git a/Documentation/doc/contributing/writing_documentation.adoc b/Documentation/doc/contributing/writing_documentation.adoc
index d61f0bd5..ecc211e2 100644
--- a/Documentation/doc/contributing/writing_documentation.adoc
+++ b/Documentation/doc/contributing/writing_documentation.adoc
@@ -1,5 +1,5 @@
 = Documentation Style Guide
-:page-nav_order: 3
+:page-nav_order: 800
 
 // SPDX-FileCopyrightText: 2023 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/development/index.adoc b/Documentation/doc/development/index.adoc
index a52c5931..7d06d039 100644
--- a/Documentation/doc/development/index.adoc
+++ b/Documentation/doc/development/index.adoc
@@ -1,5 +1,5 @@
 = Development
-:page-nav_order: 4
+:page-nav_order: 400
 
 // SPDX-FileCopyrightText: 2022 Unikie
 // SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0
diff --git a/Documentation/doc/index.adoc b/Documentation/doc/index.adoc
index 81b2a182..b7c00006 100644
--- a/Documentation/doc/index.adoc
+++ b/Documentation/doc/index.adoc
@@ -1,6 +1,6 @@
 = Documentation
 :page-liquid:
-:page-nav_order: 100
+:page-nav_order: 500
 
 // SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 // SPDX-FileCopyrightText: 2022 Unikie
diff --git a/Documentation/doc/installation/index.adoc b/Documentation/doc/installation/index.adoc
index 225abc61..517ff56c 100644
--- a/Documentation/doc/installation/index.adoc
+++ b/Documentation/doc/installation/index.adoc
@@ -1,5 +1,5 @@
 = Build and Run
-:page-nav_order: 2
+:page-nav_order: 200
 :page-has_toc: false
 
 // SPDX-FileCopyrightText: 2022 Unikie
diff --git a/Documentation/doc/using-spectrum/index.adoc b/Documentation/doc/using-spectrum/index.adoc
index 9571b50d..e7c65966 100644
--- a/Documentation/doc/using-spectrum/index.adoc
+++ b/Documentation/doc/using-spectrum/index.adoc
@@ -1,5 +1,5 @@
 = Using Spectrum
-:page-nav_order: 3
+:page-nav_order: 300
 :page-has_toc: false
 
 // SPDX-FileCopyrightText: 2022 Unikie
diff --git a/Documentation/index.html b/Documentation/index.html
index a4991e14..1c799feb 100644
--- a/Documentation/index.html
+++ b/Documentation/index.html
@@ -2,7 +2,7 @@
 layout: page
 title: Spectrum, a step towards usable secure computing
 no_heading: true
-nav_order: 0
+nav_order: 100
 ---
 <!-- SPDX-FileCopyrightText: 2019-2020, 2022, 2024 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-FileCopyrightText: 2026 Valentin Gagarin <valentin@gagarin.work> -->
diff --git a/Documentation/logo/index.html b/Documentation/logo/index.html
index fbab4432..c898b687 100644
--- a/Documentation/logo/index.html
+++ b/Documentation/logo/index.html
@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Logo
-nav_order: 1002
+nav_order: 700
 ---
 <!-- SPDX-FileCopyrightText: 2019-2020, 2022 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later -->
diff --git a/Documentation/motivation.html b/Documentation/motivation.html
index e1442517..1ff9fa30 100644
--- a/Documentation/motivation.html
+++ b/Documentation/motivation.html
@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Motivation for Spectrum
-nav_order: 1
+nav_order: 200
 ---
 <!-- SPDX-FileCopyrightText: 2019-2020, 2022 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later -->
diff --git a/Documentation/software/index.html b/Documentation/software/index.html
index 8b95c2d9..8e16017f 100644
--- a/Documentation/software/index.html
+++ b/Documentation/software/index.html
@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Spectrum software
-nav_order: 3
+nav_order: 400
 ---
 <!-- SPDX-FileCopyrightText: 2019-2020, 2022, 2024 Alyssa Ross <hi@alyssa.is> -->
 <!-- SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later -->

base-commit: a7762d6f54b40560dd5255ce902e6e6a5d980fe9
-- 
2.55.0

Re: [PATCH] Documentation: adopt a consistent nav_order format

[Valentin Gagarin]

We may want to use an explicit table of contents instead in the
future, since fumbling with the order via those numbers is needlessly
cumbersome. But that would require thinking a few things through, and
this looks good for now.

Reviewed-by: Valentin Gagarin <valentin@gagarin.work>

Re: [PATCH] Documentation: adopt a consistent nav_order format

[Alyssa Ross]

This patch has been committed as 77d2389874bb092b8dbf05ecc5b1030372e80e98,
which can be viewed online at
https://spectrum-os.org/git/spectrum/commit/?id=77d2389874bb092b8dbf05ecc5b1030372e80e98.

This is an automated message.  Send comments/questions/requests to:
Alyssa Ross <hi@alyssa.is>