Make the navigation ordering more sane

lornajane · lornajane · commit 9904a3ad416a · 2026-03-25T21:10:37.000Z
diff --git a/specification/callbacks.md b/specification/callbacks.md
@@ -2,7 +2,7 @@
 layout: default
 title: Providing Callbacks
 parent: The OpenAPI Specification Explained
-nav_order: 9
+nav_order: 11
 ---
 
 # Providing Callbacks
diff --git a/specification/components.md b/specification/components.md
@@ -2,7 +2,7 @@
 layout: default
 title: Reusing Description
 parent: The OpenAPI Specification Explained
-nav_order: 5
+nav_order: 6
 ---
 
 # Reusing Descriptions
diff --git a/specification/content.md b/specification/content.md
@@ -2,7 +2,7 @@
 layout: default
 title: Content of Message Bodies
 parent: The OpenAPI Specification Explained
-nav_order: 3
+nav_order: 4
 ---
 
 # Content of Message Bodies
diff --git a/specification/docs.md b/specification/docs.md
@@ -2,7 +2,7 @@
 layout: default
 title: Providing Documentation and Examples
 parent: The OpenAPI Specification Explained
-nav_order: 6
+nav_order: 7
 ---
 
 # Providing Documentation and Examples
diff --git a/specification/http-methods.md b/specification/http-methods.md
@@ -2,7 +2,7 @@
 layout: default
 title: HTTP Methods
 parent: The OpenAPI Specification Explained
-nav_order: 10
+nav_order: 3
 ---
 
 # HTTP Methods
diff --git a/specification/index.md b/specification/index.md
@@ -14,12 +14,15 @@ The following pages introduce the syntax and structure of an OpenAPI Description
 
 - [Structure of an OpenAPI Description](structure): JSON, YAML, `openapi`, and `info`.
 - [API Endpoints](paths): `paths` and `responses`.
+- [HTTP Methods](http-methods): standard and custom HTTP methods.
 - [Content of Message Bodies](content): `content` and `schema`.
 - [Parameters and Payload of an Operation](parameters): `parameters` and `requestBody`.
 - [Reusing Descriptions](components): `components` and `$ref`.
 - [Providing Documentation and Examples](docs): `summary`, `description` and `example`/`examples`.
 - [API Servers](servers): `servers`.
 - [Describing API Security](security): `securitySchemes` and `security`.
+- [Enhanced Tags](tags): `tags`.
 - [Providing Callbacks](callbacks): `callbacks`.
 - [Providing Webhooks](webhooks): `webhooks`.
 - [Implementing Links](links): `links`.
+- [Sequential Media Types](media-types): `itemSchema` and streaming media types.
diff --git a/specification/links.md b/specification/links.md
@@ -2,7 +2,7 @@
 layout: default
 title: Implementing Links
 parent: The OpenAPI Specification Explained
-nav_order: 10
+nav_order: 13
 ---
 
 # Implementing Links
diff --git a/specification/media-types.md b/specification/media-types.md
@@ -2,7 +2,7 @@
 layout: default
 title: Sequential Media Types
 parent: The OpenAPI Specification Explained
-nav_order: 11
+nav_order: 14
 ---
 
 # Sequential Media Types
diff --git a/specification/parameters.md b/specification/parameters.md
@@ -2,7 +2,7 @@
 layout: default
 title: Parameters and Payload of an Operation
 parent: The OpenAPI Specification Explained
-nav_order: 4
+nav_order: 5
 ---
 
 # Parameters and Payload of an Operation
diff --git a/specification/security.md b/specification/security.md
@@ -2,7 +2,7 @@
 layout: default
 title: Describing API Security
 parent: The OpenAPI Specification Explained
-nav_order: 8
+nav_order: 9
 ---
 
 # Describing API Security
diff --git a/specification/servers.md b/specification/servers.md
@@ -2,7 +2,7 @@
 layout: default
 title: API Servers
 parent: The OpenAPI Specification Explained
-nav_order: 7
+nav_order: 8
 ---
 
 # API Servers
diff --git a/specification/tags.md b/specification/tags.md
@@ -2,7 +2,7 @@
 layout: default
 title: Enhanced Tags
 parent: The OpenAPI Specification Explained
-nav_order: 9
+nav_order: 10
 ---
 
 # Enhanced Tags
diff --git a/specification/webhooks.md b/specification/webhooks.md
@@ -2,7 +2,7 @@
 layout: default
 title: Providing Webhooks
 parent: The OpenAPI Specification Explained
-nav_order: 9
+nav_order: 12
 ---
 
 # Providing Webhooks
