summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorYuriy Andamasov <yuriy@vyos.io>2026-05-07 09:34:19 +0300
committerYuriy Andamasov <yuriy@vyos.io>2026-05-07 09:34:19 +0300
commit5fe7f9ad745696076dae479a23431b22f67abea4 (patch)
treeb36712bce128ae27e9885cf0d5d44caaf509dd8c /docs
parent8a7e96d6fa25a1098c134146883d4f577ab229ca (diff)
downloadvyos-documentation-5fe7f9ad745696076dae479a23431b22f67abea4.tar.gz
vyos-documentation-5fe7f9ad745696076dae479a23431b22f67abea4.zip
docs(llms.txt): point links at .md sources, not .html
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/<ver>/<page>.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)
Diffstat (limited to 'docs')
-rw-r--r--docs/_templates/llms.txt.j244
1 files changed, 22 insertions, 22 deletions
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