docs: convert _include/interface-vlan-8021ad.txt MyST cmdincludemd -> RST

2026-05-13T23:58:29+00:00

fix(includes): break the RST `.. include::` chain that pulls need_improvement.txt on sagitta

2026-05-13T22:29:27+00:00

`_include/interface-vlan-8021ad.txt` started with `.. include:: /_include/need_improvement.txt`. After PR #2008 the `{cmdincludemd}` directive parses included `.txt` content as RST, so the three MD pages that consume interface-vlan-8021ad.txt (ethernet.md:161, virtual-ethernet.md:46, wireless.md:485) reach need_improvement.txt through an RST parser. `need_improvement.txt` is now MyST (`::::{only} not latex / :::{admonition}`), so the RST parser would render those directives as literal text on three interface pages. Rolling does not have this regression — rolling's `_include/interface-vlan-8021ad.txt` is MyST/MD content and does not include need_improvement.txt at all. The sagitta file is older RST-shape content with the include chain at the top, an artifact of the mid-migration state on sagitta. Strip line 1 (`.. include:: /_include/need_improvement.txt`) and the blank line that follows. The QinQ overview content below is untouched and still parses as RST under `{cmdincludemd}`. Spotted by Copilot inline review on #2026. 🤖 Generated by [robots](https://vyos.io)

feat: import MyST swap mechanism + content for sagitta (replaces #1886)

2026-05-06T15:46:21+00:00

Replaces the broken #1886 with a fresh, properly-converted MyST set for the sagitta (1.4.x) docs, mirroring what landed for circinus via #1897. This PR: - Re-imports 210 md-*.md files for sagitta. Source: ran the pipelines rst-to-myst converter (chrisjsewell/rst-to-myst v0.4.0, with pandoc fallback) on sagittas RST. Post-processed via the pipelines postprocess stage (10 ordered fixes for blanks, admonitions, label hyphens, pandoc artifacts, structural blanks, linter markers). Compared to the broken #1886 content (which was left over from an earlier stage-1-only run): zero raw `

` remnants. - For 23 stems where sagittas RST is byte-identical with currents RST (mostly stable policy/protocol pages and the 404 page), reuses currents already-validated md-*.md content rather than re-converting. - Drops cli and installation/cloud/aws from sagittas swap set: their RST has SEVERE/4 "Title level inconsistent" errors that crash rst-to-myst; they need an independent RST-source fix and are kept as RST-only for now. - Adds the per-page swap mechanism: scripts/swap_sources.py, scripts/import_myst.py, the matching tests under tests/, _swap.txt with 210 stems, _ext/vyos.py MyST renderer fallback, Makefile swap-wrapped targets, .readthedocs.yml swap pre/post hooks. - Adds 187 .webp images and removes 235 superseded .jpg/.png/.jpeg static assets; flips html_logo to vyos-logo.webp. - Adds the MyST swap-related blocks to docs/conf.py only: myst_enable_extensions, myst_fence_as_directive, md-*.md exclude patterns, _swap_exclude.txt reader, _prefer_webp and _copy_md_sources setup hooks. github_version fallback set to 'sagitta' to match the branch (parallel to currents 'current' and circinuss 'circinus'). Deliberately excluded (per user direction): - llms.txt and sphinx-llms-txt / sphinx-sitemap config: these will land separately for sagitta via #1870 plus a new sagitta-specific llms.txt template PR. The conf.py here does not pull those extensions in, so the build does not depend on the new pip packages. Verification before pushing: - 210 md-*.md = 210 _swap.txt stems = 210 RST siblings on sagitta (1:1:1). - 0 files contain raw `

Remove dedicated adjust-mss from 8021ad

2022-01-15T12:03:06+00:00

interfaces: T3090: add new TCP MSS clamping CLI commands

2021-10-08T19:33:17+00:00

fix build error after merge

2020-12-08T14:12:56+00:00

Merge branch 'sagitta' of https://github.com/rebortg/vyos-documentation

2020-12-08T13:57:44+00:00

arrange examples

2020-12-06T20:41:10+00:00

change include to absolute path

2020-11-30T18:46:59+00:00

include: interface: fix ipv6 dhcp pd

2020-11-27T19:05:22+00:00

vyos-documentation.git/docs/_include/interface-vlan-8021ad.txt, branch 1.4