From 5fe7f9ad745696076dae479a23431b22f67abea4 Mon Sep 17 00:00:00 2001 From: Yuriy Andamasov Date: Thu, 7 May 2026 09:34:19 +0300 Subject: docs(llms.txt): point links at .md sources, not .html MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per the [llms.txt spec](https://llmstxt.org/), `/llms.txt` links should point at markdown files (the spec example: `[API docs](https://example.com/api.md)`). We were using `.html` URLs, which still work but force LLM consumers through HTML parsing for content that's already available as raw MyST at the same path (the `.md` is copied to HTML root by `_copy_md_sources`). Pivot the curated llms.txt template to `.md` URLs across all 22 entries. Spec-compliant, no extra requests, LLMs get raw markdown without the navigation chrome. Verified locally: `/en//.md` returns 200 with raw MyST content (frontmatter + body) for all linked paths on this branch. Same pivot applied symmetrically across [#1874](https://github.com/vyos/vyos-documentation/pull/1874) (current), [#1876](https://github.com/vyos/vyos-documentation/pull/1876) (sagitta), and [#1903](https://github.com/vyos/vyos-documentation/pull/1903) (circinus). 🤖 Generated by [robots](https://vyos.io) --- docs/_templates/llms.txt.j2 | 44 ++++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) (limited to 'docs') diff --git a/docs/_templates/llms.txt.j2 b/docs/_templates/llms.txt.j2 index db579e83..1c6a3900 100644 --- a/docs/_templates/llms.txt.j2 +++ b/docs/_templates/llms.txt.j2 @@ -10,43 +10,43 @@ VyOS configuration follows a tree structure. All configuration commands start wi ## Quick Start -- [Quick Start Guide]({{ baseurl }}quick-start.html): Minimal setup walkthrough -- [CLI Overview]({{ baseurl }}cli.html): Command-line interface usage +- [Quick Start Guide]({{ baseurl }}quick-start.md): Minimal setup walkthrough +- [CLI Overview]({{ baseurl }}cli.md): Command-line interface usage ## Configuration -- [Firewall]({{ baseurl }}configuration/firewall/index.html): Zone-based firewall, rules, groups -- [Interfaces]({{ baseurl }}configuration/interfaces/index.html): Ethernet, bonding, bridge, VLAN, tunnel, wireless -- [Protocols]({{ baseurl }}configuration/protocols/index.html): BGP, OSPF, IS-IS, static routing, MPLS -- [VPN]({{ baseurl }}configuration/vpn/index.html): IPsec, OpenVPN, WireGuard, L2TP, PPTP -- [NAT]({{ baseurl }}configuration/nat/index.html): Source NAT, destination NAT, NAT66 -- [System]({{ baseurl }}configuration/system/index.html): DNS, NTP, syslog, users, task scheduler -- [High Availability]({{ baseurl }}configuration/highavailability/index.html): VRRP -- [Load Balancing]({{ baseurl }}configuration/loadbalancing/index.html): WAN and reverse proxy -- [Containers]({{ baseurl }}configuration/container/index.html): Podman-based container support -- [PKI]({{ baseurl }}configuration/pki/index.html): Certificate management -- [Policy]({{ baseurl }}configuration/policy/index.html): Route maps, prefix lists, access lists -- [Traffic Policy]({{ baseurl }}configuration/trafficpolicy/index.html): QoS and shaping -- [Service]({{ baseurl }}configuration/service/index.html): DHCP, DNS forwarding, SNMP, SSH, HTTPS API -- [VRF]({{ baseurl }}configuration/vrf/index.html): Virtual routing and forwarding +- [Firewall]({{ baseurl }}configuration/firewall/index.md): Zone-based firewall, rules, groups +- [Interfaces]({{ baseurl }}configuration/interfaces/index.md): Ethernet, bonding, bridge, VLAN, tunnel, wireless +- [Protocols]({{ baseurl }}configuration/protocols/index.md): BGP, OSPF, IS-IS, static routing, MPLS +- [VPN]({{ baseurl }}configuration/vpn/index.md): IPsec, OpenVPN, WireGuard, L2TP, PPTP +- [NAT]({{ baseurl }}configuration/nat/index.md): Source NAT, destination NAT, NAT66 +- [System]({{ baseurl }}configuration/system/index.md): DNS, NTP, syslog, users, task scheduler +- [High Availability]({{ baseurl }}configuration/highavailability/index.md): VRRP +- [Load Balancing]({{ baseurl }}configuration/loadbalancing/index.md): WAN and reverse proxy +- [Containers]({{ baseurl }}configuration/container/index.md): Podman-based container support +- [PKI]({{ baseurl }}configuration/pki/index.md): Certificate management +- [Policy]({{ baseurl }}configuration/policy/index.md): Route maps, prefix lists, access lists +- [Traffic Policy]({{ baseurl }}configuration/trafficpolicy/index.md): QoS and shaping +- [Service]({{ baseurl }}configuration/service/index.md): DHCP, DNS forwarding, SNMP, SSH, HTTPS API +- [VRF]({{ baseurl }}configuration/vrf/index.md): Virtual routing and forwarding ## Operations -- [Operational Commands]({{ baseurl }}operation/index.html): Show, monitor, restart commands +- [Operational Commands]({{ baseurl }}operation/index.md): Show, monitor, restart commands ## Installation -- [Installation Guide]({{ baseurl }}installation/index.html): Bare metal, virtual, cloud deployments +- [Installation Guide]({{ baseurl }}installation/index.md): Bare metal, virtual, cloud deployments ## Automation -- [Automation]({{ baseurl }}automation/index.html): Ansible, Terraform, HTTP API, NETCONF +- [Automation]({{ baseurl }}automation/index.md): Ansible, Terraform, HTTP API, NETCONF ## Configuration Examples -- [Blueprints]({{ baseurl }}configexamples/index.html): Real-world topology examples +- [Blueprints]({{ baseurl }}configexamples/index.md): Real-world topology examples ## Optional -- [Contributing]({{ baseurl }}contributing/index.html): Development workflow -- [VPP]({{ baseurl }}vpp/index.html): Vector Packet Processing integration +- [Contributing]({{ baseurl }}contributing/index.md): Development workflow +- [VPP]({{ baseurl }}vpp/index.md): Vector Packet Processing integration -- cgit v1.2.3