From 6e7e58a46545109035803990cbb69610098c5913 Mon Sep 17 00:00:00 2001 From: matthieugouel Date: Tue, 16 Jun 2026 16:55:19 +0200 Subject: [PATCH 1/2] docs: enable LLM-friendly outputs (llms.txt + per-page markdown) Opt into the hextra >= 0.12 output formats: a /llms.txt index of the whole site and a raw-markdown twin of every page. Addresses the 'one-page LLM docs' roadmap idea. RSS is preserved on home/section outputs. Co-Authored-By: Claude Opus 4.8 (1M context) --- hugo.toml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/hugo.toml b/hugo.toml index eaae565..8fc6d2e 100644 --- a/hugo.toml +++ b/hugo.toml @@ -11,6 +11,12 @@ theme = "hextra" [markup.highlight] noClasses = false +# LLM-friendly output (hextra >= 0.12): /llms.txt index + per-page raw markdown. +[outputs] + home = ["HTML", "RSS", "llms"] + section = ["HTML", "RSS", "markdown"] + page = ["HTML", "markdown"] + [[menu.main]] name = "Search" From c94d1686b29291bd7061db13d03f56b9888f2807 Mon Sep 17 00:00:00 2001 From: matthieugouel Date: Tue, 16 Jun 2026 16:59:10 +0200 Subject: [PATCH 2/2] docs: document the LLM-friendly outputs (llms.txt + per-page markdown) Add a Tools > LLM-Friendly Docs page describing /llms.txt and the per-page .md access, and slot it into the section nav (after MCP Servers). Co-Authored-By: Claude Opus 4.8 (1M context) --- content/docs/internals/_index.md | 2 +- content/docs/tools/llms.md | 26 ++++++++++++++++++++++++++ content/docs/tools/mcp.md | 2 +- 3 files changed, 28 insertions(+), 2 deletions(-) create mode 100644 content/docs/tools/llms.md diff --git a/content/docs/internals/_index.md b/content/docs/internals/_index.md index e166e98..3bf0d84 100644 --- a/content/docs/internals/_index.md +++ b/content/docs/internals/_index.md @@ -1,7 +1,7 @@ --- title: Internals weight: 6 -prev: /docs/tools/mcp/ +prev: /docs/tools/llms/ next: /docs/internals/infrastructure/ --- diff --git a/content/docs/tools/llms.md b/content/docs/tools/llms.md new file mode 100644 index 0000000..2072442 --- /dev/null +++ b/content/docs/tools/llms.md @@ -0,0 +1,26 @@ +--- +title: LLM-Friendly Docs +weight: 5 +prev: /docs/tools/mcp/ +next: /docs/internals/ +--- + +This documentation is published in machine-readable formats so that large language models and AI agents can consume it directly, without scraping rendered HTML. + +## llms.txt + +A single index of the whole documentation is available at [/llms.txt](https://docs.nxthdr.dev/llms.txt), following the [llms.txt convention](https://llmstxt.org/). It lists every page with a short summary and a direct link, giving an agent a compact map of the docs in one request. + +## Per-page Markdown + +Every page is also available as raw Markdown. Append `.md` to a page's path, or use `index.md` for a section's landing page. For example: + +- [/docs/peering/getting-started.md](https://docs.nxthdr.dev/docs/peering/getting-started.md) +- [/docs/probing/probes.md](https://docs.nxthdr.dev/docs/probing/probes.md) +- [/docs/peering/index.md](https://docs.nxthdr.dev/docs/peering/index.md) (section landing page) + +This gives agents clean, structure-preserving content to ingest instead of HTML. + +## Querying the data + +To go beyond the documentation and query the open datasets in natural language, see the [MCP Servers](/docs/tools/mcp/) page. diff --git a/content/docs/tools/mcp.md b/content/docs/tools/mcp.md index 0309990..03d434f 100644 --- a/content/docs/tools/mcp.md +++ b/content/docs/tools/mcp.md @@ -1,7 +1,7 @@ --- title: MCP Servers weight: 4 -next: /docs/internals/ +next: /docs/tools/llms/ --- Since **nxthdr** datasets are stored in ClickHouse, you can use the official MCP server for ClickHouse [mcp-clickhouse](https://github.com/ClickHouse/mcp-clickhouse) to query the data.