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-13T23:15:48+00:00 2026-05-13T23:15:48+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-13T22:54:50+00:00 urn:sha1:19bc61862c3ae32cfe85740dde267c38321db915 doc-lint regression on [vyos-documentation#2024](https://github.com/vyos/vyos-documentation/pull/2024): the CI workflow's `scripts/doc-linter.py` scans every line of every changed file (not just changed lines), so the typo fix on `cli.md:464` and the capitalization fix on `aws.md:118` surfaced 57 pre-existing >80-char violations that have lived on rolling since the MyST migration. `cli.md` — 53 prose paragraphs hard-wrapped at word boundaries to 80 chars, preserving content fidelity. List items use hanging-indent continuations under their `- ` marker. No content reworded; only soft-wrap → hard-wrap. `aws.md` — wrapped the inline AWS GWLB blog link (L164) and the References section (L185-187) with `% stop_vyoslinter` / `% start_vyoslinter` markers. These are URL-bearing lines that cannot be shortened (URL itself >80 chars). Verified locally: `python3 scripts/doc-linter.py "['docs/cli.md','docs/installation/cloud/aws.md','docs/automation/terraform/terraformvyos.md']"` → exit 0, no violations. 🤖 Generated by [robots](https://vyos.io) 2026-05-13T23:14:54+00:00 Yuriy Andamasov yuriy@vyos.io 2026-05-13T21:51:12+00:00 urn:sha1:8c19456b7775f0e1a1f0e9e3d5941639702e2876 Three pre-existing rolling docs bugs, surfaced by Copilot review on the sagitta RST→MD conversion PR #2022 against the byte-for-byte ports of `cli.md` and `aws.md`: - `cli.md` line 464: `set interface ethernet …` is wrong; the CLI command is `set interfaces ethernet …` (plural). Users copying the example verbatim would hit "Configuration path is not valid". - `cli.md` lines 527-528: orphan `:::` / `::::` fence closers after the `{cfgcmd} save` block. The `(save)=` directive opens at line 503 and closes at line 506; the two `` ``` none `` blocks at 508-526 are self-contained; nothing opens these colon fences. MyST/Sphinx tolerates them silently today but they're literal noise. Drop both. - `aws.md` line 118: "Cloudwatch" → "CloudWatch", matching the surrounding correctly-cased uses on lines 115/121/122 and AWS's product naming. Mergify will backport to circinus and sagitta via the standard `@Mergifyio backport circinus sagitta` post-merge. 🤖 Generated by [robots](https://vyos.io) 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)