thokra-nav · Oct 13, 2026 · Sep 14, 2026
diff --git a/README.md b/README.md
@@ -29,6 +29,20 @@ conditional: [tenant, nav, ssb]
               ^^^^^^--- the keyword "tenant" is required to exclude all not mentioned
 ```
 
+## llms.txt curation
+
+Add selected entry-point pages to `llms.txt` with global ordering metadata:
+
+```yaml
+llms:
+  section: Workloads
+  order: 30
+```
+
+Pages are grouped by `section` and ordered by the numeric `order`. Every
+rendered documentation page is also available as Markdown at its canonical
+path with a `.md` suffix; the root `README.md` is `/index.md`.
+
 ## Copilot Agents
 
 Four agents handle documentation tasks:

diff --git a/docs/README.md b/docs/README.md
@@ -1,5 +1,8 @@
 ---
 title: Nais Developer Documentation
+llms:
+  section: Core and getting started
+  order: 10
 hide:
   - feedback
   - footer

diff --git a/docs/auth/README.md b/docs/auth/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [auth, explanation]
+llms:
+  section: Authentication
+  order: 100
 description: Services and addons to support authentication and authorization in your applications.
 ---
 

diff --git a/docs/auth/entra-id/README.md b/docs/auth/entra-id/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [auth, entra-id, azure-ad, services, explanation]
+llms:
+  section: Authentication
+  order: 110
 conditional: [tenant, nav]
 ---
 

diff --git a/docs/auth/idporten/README.md b/docs/auth/idporten/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [auth, idporten, services, explanation]
+llms:
+  section: Authentication
+  order: 120
 conditional: [tenant, nav]
 ---
 

diff --git a/docs/build/README.md b/docs/build/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [build, deploy, explanation, services]
+llms:
+  section: Build and deploy
+  order: 40
 ---
 
 # Build and deploy

diff --git a/docs/build/how-to/build-and-deploy.md b/docs/build/how-to/build-and-deploy.md
@@ -1,5 +1,8 @@
 ---
 tags: [build, deploy, how-to]
+llms:
+  section: Build and deploy
+  order: 50
 ---
 
 # Build and deploy with GitHub Actions

diff --git a/docs/explanations/nais.md b/docs/explanations/nais.md
@@ -1,5 +1,8 @@
 ---
 tags: [explanation, nais]
+llms:
+  section: Core and getting started
+  order: 20
 ---
 
 # What is Nais?

diff --git a/docs/observability/README.md b/docs/observability/README.md
@@ -5,6 +5,9 @@ description: >-
 search:
   boost: 1
 tags: [explanation, observability]
+llms:
+  section: Observability
+  order: 180
 ---
 
 # Observability

diff --git a/docs/observability/logging/README.md b/docs/observability/logging/README.md
@@ -1,6 +1,9 @@
 ---
 description: Understand how application logging works in Nais, its purpose, good practices, and the available log destinations.
 tags: [explanation, logging, observability, services]
+llms:
+  section: Observability
+  order: 190
 ---
 
 # Logging

diff --git a/docs/observability/metrics/README.md b/docs/observability/metrics/README.md
@@ -1,6 +1,9 @@
 ---
 description: Metrics are a way to measure the state of your application and can be used to create alerts and dashboards in Grafana.
 tags: [explanation, metrics, observability, services]
+llms:
+  section: Observability
+  order: 200
 ---
 
 # Metrics

diff --git a/docs/observability/tracing/README.md b/docs/observability/tracing/README.md
@@ -2,6 +2,9 @@
 description: >-
   Application Performance Monitoring or tracing using Grafana Tempo on Nais.
 tags: [explanation, observability, tracing, services]
+llms:
+  section: Observability
+  order: 210
 ---
 
 # Distributed Tracing

diff --git a/docs/operate/README.md b/docs/operate/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [explanation, operate]
+llms:
+  section: Services and operations
+  order: 240
 ---
 
 # Manage your workloads and services

diff --git a/docs/persistence/README.md b/docs/persistence/README.md
@@ -3,6 +3,9 @@ description: >-
   Nais offers several storage solutions for storing data. This page describes
   the different options and how to use them.
 tags: [persistence, explanation]
+llms:
+  section: Persistence
+  order: 130
 ---
 
 # Persistent Data Overview

diff --git a/docs/persistence/cloudsql/README.md b/docs/persistence/cloudsql/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [explanation, persistence, services]
+llms:
+  section: Persistence
+  order: 150
 ---
 
 # Google Cloud SQL / PostgreSQL

diff --git a/docs/persistence/kafka/README.md b/docs/persistence/kafka/README.md
@@ -4,6 +4,9 @@ description: >-
   subscribe to streams of records. It is a good alternative to synchronous
   communication between services if you need to decouple services.
 tags: [kafka, explanation, persistence, services]
+llms:
+  section: Persistence
+  order: 140
 ---
 
 # Kafka

diff --git a/docs/persistence/opensearch/README.md b/docs/persistence/opensearch/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [opensearch, explanation, persistence, services]
+llms:
+  section: Persistence
+  order: 160
 description: >-
   Nais provides managed search index services through OpenSearch as a drop-in
   replacement for Elasticsearch.

diff --git a/docs/persistence/valkey/README.md b/docs/persistence/valkey/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [persistence, explanation, valkey, redis, services]
+llms:
+  section: Persistence
+  order: 170
 ---
 # Valkey
 

diff --git a/docs/services/README.md b/docs/services/README.md
@@ -1,3 +1,9 @@
+---
+llms:
+  section: Services and operations
+  order: 220
+---
+
 # Other services
 
 This section covers the rest of the Nais functionality that didn't fit into any other categories.

diff --git a/docs/services/secrets/README.md b/docs/services/secrets/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [secrets, explanation, services]
+llms:
+  section: Services and operations
+  order: 230
 ---
 
 # Secrets

diff --git a/docs/tutorials/hello-nais.md b/docs/tutorials/hello-nais.md
@@ -1,5 +1,8 @@
 ---
 tags: [tutorial]
+llms:
+  section: Core and getting started
+  order: 30
 ---
 # :wave: Hello Nais
 

diff --git a/docs/workloads/README.md b/docs/workloads/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [workloads, explanation]
+llms:
+  section: Workloads
+  order: 60
 ---
 
 # Workloads

diff --git a/docs/workloads/application/README.md b/docs/workloads/application/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [application, explanation, workloads, services]
+llms:
+  section: Workloads
+  order: 70
 ---
 
 # Application

diff --git a/docs/workloads/application/how-to/create.md b/docs/workloads/application/how-to/create.md
@@ -1,5 +1,8 @@
 ---
 tags: [application, how-to]
+llms:
+  section: Workloads
+  order: 80
 ---
 
 # Create application

diff --git a/docs/workloads/job/README.md b/docs/workloads/job/README.md
@@ -1,5 +1,8 @@
 ---
 tags: [job, explanation, workloads, services]
+llms:
+  section: Workloads
+  order: 90
 ---
 
 # Nais job