diff options
| author | Yuriy Andamasov <yuriy@vyos.io> | 2026-05-07 09:34:19 +0300 |
|---|---|---|
| committer | Yuriy Andamasov <yuriy@vyos.io> | 2026-05-07 09:34:19 +0300 |
| commit | 5fe7f9ad745696076dae479a23431b22f67abea4 (patch) | |
| tree | b36712bce128ae27e9885cf0d5d44caaf509dd8c /docs | |
| parent | 8a7e96d6fa25a1098c134146883d4f577ab229ca (diff) | |
| download | vyos-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.j2 | 44 |
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 |
