VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git) https://git.amelek.net/vyos/vyos-documentation.git/atom?h=1.4 2026-05-13T21:36:01+00:00 2026-05-13T21:36:01+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-13T21:36:01+00:00 urn:sha1:9340e43951d20c388f1d627b1e003a25529067f4 Port docs/cli.md and docs/installation/cloud/aws.md from rolling (the canonical, production-tested MyST versions) and remove the remaining cli.rst + aws.rst. Earlier conversion attempts on myst/sagitta had title-level errors flagged for separate fix; rolling's versions are clean. Drop the `cli.html` workaround in `_templates/llms.txt.j2` now that `cli.md` exists and is copied by `_copy_md_sources` — matches the rolling-branch template byte for byte at that line. 🤖 Generated by [robots](https://vyos.io) 2026-05-07T06:34:21+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-07T06:34:21+00:00 urn:sha1:429463d9bcb177c7715e8e0cf5e3d22212ecfaa7 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 22 of 23 entries. The single exception is `cli.html` — sagitta's `docs/cli.rst` hasn't been migrated to MyST (rst-to-myst chokes on the heading hierarchy), so no `cli.md` is served at the HTML root. A Jinja comment in the template documents the exception and references the follow-up cli.rst migration as a separate PR. Verified locally: every linked `.md` path returns 200 in production. 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) 2026-05-04T08:07:46+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-04T08:07:46+00:00 urn:sha1:ab5bcd24bb8c3e311e31c09980c8defefb3c8e74 - Pin sphinx-llms-txt 0.7.1 and sphinx-sitemap 2.9.0 - Set html_baseurl to https://docs.vyos.io/en/sagitta/ - llms.txt rendered at build time from a Jinja template; llms-full.txt auto-generated by sphinx-llms-txt - Optional section adapted to sagitta layout (no contributing index, no VPP) - Same change applied to current and circinus in separate PRs 🤖 Generated by [robots](https://vyos.io)