<feed xmlns='http://www.w3.org/2005/Atom'>
<title>vyos-documentation.git/docs/configexamples, branch mergify/bp/circinus/pr-2233</title>
<subtitle>VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git)
</subtitle>
<id>https://git.amelek.net/vyos/vyos-documentation.git/atom?h=mergify%2Fbp%2Fcircinus%2Fpr-2233</id>
<link rel='self' href='https://git.amelek.net/vyos/vyos-documentation.git/atom?h=mergify%2Fbp%2Fcircinus%2Fpr-2233'/>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/'/>
<updated>2026-09-04T08:59:25+00:00</updated>
<entry>
<title>docs: clarify Google Cloud peer gateway wording</title>
<updated>2026-09-04T08:59:25+00:00</updated>
<author>
<name>Jeleel Muibi</name>
<email>jeleel-muibi@users.noreply.github.com</email>
</author>
<published>2026-07-09T19:27:52+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=e29537eaec541b1a898b4c6c59b970d665c23e91'/>
<id>urn:sha1:e29537eaec541b1a898b4c6c59b970d665c23e91</id>
<content type='text'>
(cherry picked from commit 7662f4c3684fbc684228e0bda2ef4594f49a0e9a)
</content>
</entry>
<entry>
<title>docs: disable IPsec route autoinstall in GCP example</title>
<updated>2026-09-04T08:59:25+00:00</updated>
<author>
<name>Jeleel Muibi</name>
<email>jeleel-muibi@users.noreply.github.com</email>
</author>
<published>2026-07-09T19:25:14+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=9077903dba7244e61f592eac6ba1e00224047c6f'/>
<id>urn:sha1:9077903dba7244e61f592eac6ba1e00224047c6f</id>
<content type='text'>
(cherry picked from commit 6c3f55ab592927fdbe67739b33707eac02d2f57e)
</content>
</entry>
<entry>
<title>docs: refine Google Cloud VPN example</title>
<updated>2026-09-04T08:59:24+00:00</updated>
<author>
<name>Jeleel Muibi</name>
<email>jeleel-muibi@users.noreply.github.com</email>
</author>
<published>2026-07-09T19:21:55+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=15223ed5dbc700f4f5ea70ee56f22432ab5c7c85'/>
<id>urn:sha1:15223ed5dbc700f4f5ea70ee56f22432ab5c7c85</id>
<content type='text'>
(cherry picked from commit 367585ea4de297f375c30424b78dd9dedab09874)
</content>
</entry>
<entry>
<title>docs: add Google Cloud HA VPN BGP example</title>
<updated>2026-09-04T08:59:24+00:00</updated>
<author>
<name>Jeleel Muibi</name>
<email>jeleel-muibi@users.noreply.github.com</email>
</author>
<published>2026-07-09T19:13:21+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=e4859ad3e1c5251fdfa0805c925c687b085c2ca1'/>
<id>urn:sha1:e4859ad3e1c5251fdfa0805c925c687b085c2ca1</id>
<content type='text'>
(cherry picked from commit 42b8198e4323c89490df80c0058ad890849172bf)
</content>
</entry>
<entry>
<title>docs(DMVPN): T4667: Add firewall rule to prevent unencrypted GRE leaks (#2136) (#2144)</title>
<updated>2026-08-04T10:15:07+00:00</updated>
<author>
<name>mergify[bot]</name>
<email>37929162+mergify[bot]@users.noreply.github.com</email>
</author>
<published>2026-08-04T10:15:07+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=c0dd3eabe5da57f772f325896a3869c21c061954'/>
<id>urn:sha1:c0dd3eabe5da57f772f325896a3869c21c061954</id>
<content type='text'>
* docs(DMVPN): T4667: Add firewall rule to prevent unencrypted GRE leaks

In DMVPN the mGRE tunnel and the IPSec protecting it are handled
independently, so GRE can be forwarded while no IPSec SA is active for a
peer (e.g. while an SA is still being negotiated or after one expires),
allowing unencrypted GRE to leave the router. This is inherent to
combining GRE with IPSec and is common to DMVPN implementations in
general.

Add a "Protecting against unencrypted traffic leaks" section to the DMVPN
reference page explaining the behaviour and recommending an output filter
rule that drops GRE not matched by an outbound IPSec policy
(ipsec match-none-out). Note that this disables unencrypted GRE on the
node entirely, so coexisting plain GRE tunnels would stop working.

Apply the same rule in the Dual HUB Dual Cloud example on the VyOS nodes.



* docs(DMVPN): reflow DMVPN documentation for line length compliance

Reformat the DMVPN guide and dual-hub dual-cloud example to wrap
long lines and improve readability without changing the documented
behavior or configuration guidance.

---------


(cherry picked from commit 50acf8f188475b0554b99a739cb8ada12d51e77b)

Co-authored-by: zdc &lt;zdc@users.noreply.github.com&gt;
Co-authored-by: Daniil Baturin &lt;daniil@baturin.org&gt;</content>
</entry>
<entry>
<title>configexamples/inter-vrf-routing-vrf-lite: fix formatting (#2112)</title>
<updated>2026-06-23T10:26:54+00:00</updated>
<author>
<name>Nico Felbinger</name>
<email>26925347+felbinger@users.noreply.github.com</email>
</author>
<published>2026-06-23T10:26:54+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=c1fd4992e4c8bb16c388f255fc2a612dc5dc4251'/>
<id>urn:sha1:c1fd4992e4c8bb16c388f255fc2a612dc5dc4251</id>
<content type='text'>
* configexamples/inter-vrf-routing-vrf-lite: fix formatting

* configexamples/inter-vrf-routing-vrf-lite: reformat text to limit line length</content>
</entry>
<entry>
<title>chore: remove RST swap mechanism, archive rst-*.rst under docs/_rst_legacy/</title>
<updated>2026-05-10T14:23:58+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@vyos.io</email>
</author>
<published>2026-05-10T14:23:58+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=b6ff49dc4873e370083205d2f12bb2eb3894c7bc'/>
<id>urn:sha1:b6ff49dc4873e370083205d2f12bb2eb3894c7bc</id>
<content type='text'>
The swap mechanism (RST-as-fallback for migrated MD pages) is dormant —
docs/_rst_overrides.txt has been empty since the MyST flip trio
(#1899/#1900/#1901) landed. The mechanism's surface area is dead weight
and the rst-*.rst shadows scattered across the source tree cause
Context7's parser to misclassify the project as RST.

Sibling PR on rolling: yuriy/remove-rst-swap-mechanism

Changes:
- Move 253 rst-*.rst shadow files into docs/_rst_legacy/ preserving
  subdirectory structure. They remain in the repo for reference; Sphinx
  excludes the folder via exclude_patterns.
- Strip swap_sources.py invocation from docs/Makefile.
- Strip jobs: pre_build/post_build block from .readthedocs.yml.
- Strip rst-*.rst exclude entry and the _md_exclude.txt loader from
  docs/conf.py; replace with a single _rst_legacy exclude.
- Delete scripts/swap_sources.py, tests/test_swap_sources.py,
  docs/_rst_overrides.txt.
- Update AGENTS.md: drop the "RST override mechanism" section and the
  test-runner snippet for the deleted test.

Verified: sphinx-build -b html with --keep-going produces identical
warning set (68 unique), identical sitemap entry count (267), identical
llms.txt entry count (22), zero rst-* URLs in any artifact.

🤖 Generated by [robots](https://vyos.io)
</content>
</entry>
<entry>
<title>feat: flip swap mechanism on circinus — MD as primary, RST as override</title>
<updated>2026-05-06T18:08:17+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@vyos.io</email>
</author>
<published>2026-05-06T18:08:17+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=3edf063d4d27d6132c67024b9560c0075fe7a48e'/>
<id>urn:sha1:3edf063d4d27d6132c67024b9560c0075fe7a48e</id>
<content type='text'>
Mirror of #1899 for circinus. Same logic, same scripts, per-branch file set.

Changes:
- Rename docs/**/md-&lt;stem&gt;.md to docs/**/&lt;stem&gt;.md (drop md- prefix) for
  all 253 stems previously listed in docs/_swap.txt
- Rename docs/**/&lt;stem&gt;.rst to docs/**/rst-&lt;stem&gt;.rst (add rst- prefix)
  for the same 253 stems
- Repurpose docs/_swap.txt as docs/_rst_overrides.txt; initially empty
- conf.py exclude_patterns flipped: rst-*.rst excluded by default
- conf.py runtime-artifact references updated to _rst_override_state.json
  and _md_exclude.txt
- scripts/swap_sources.py rewritten with inverted rename direction
  (rst-&lt;stem&gt;.rst → &lt;stem&gt;.rst when applying overrides; &lt;stem&gt;.md
  excluded via _md_exclude.txt)
- scripts/import_myst.py and tests/test_import_myst.py deleted (obsolete)
- tests/test_swap_sources.py rewritten for new semantics

Identical change set to #1899 (current). Per-branch differences:
- circinus has 253 stems vs current's 254 (suricata is current-only)
- otherwise the script/conf.py/test changes are byte-identical with current

Generated by robots https://vyos.io
</content>
</entry>
<entry>
<title>feat: import MyST swap mechanism, llms.txt feature, and content from current</title>
<updated>2026-05-06T14:47:58+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@vyos.io</email>
</author>
<published>2026-05-06T14:47:58+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=b61087c396860bb507be1adea50244a8c8e3242c'/>
<id>urn:sha1:b61087c396860bb507be1adea50244a8c8e3242c</id>
<content type='text'>
Replaces the broken #1885/#1869/#1875 trio with a single PR for circinus.

This PR:
- Imports 254 md-*.md files from currents working MyST conversion (the
  broken converter that produced #1885s md-*.md files is not used here;
  currents files are correct as verified on /en/rolling/).
- Adds the per-page RST-to-MyST swap mechanism: scripts/swap_sources.py,
  scripts/import_myst.py, tests, _swap.txt, _ext/vyos.py and Makefile
  swap-wrapped targets, .readthedocs.yml pre/post hooks.
- Replaces 175 .jpg/.png with 187 .webp images for swapped pages.
- Adds the llms.txt + sitemap feature (sphinx_llms_txt, sphinx_sitemap)
  with circinus-tailored html_baseurl https://docs.vyos.io/en/1.5/ and
  curated docs/_html_extra/llms.txt for 1.5.x.
- Updates docs/_html_extra/robots.txt with AI crawler Allow rules and
  the /en/1.5/sitemap.xml reference.
- Drops configuration/service/suricata from the swap set (no matching
  RST sibling on circinus; suricata is a current-only feature).

Supersedes:
- #1885 (broken md-*.md converter output)
- #1869 (LLM doc adaptation backport, bundled here)
- #1875 (llms.txt circinus, bundled here)

Generated by robots https://vyos.io
</content>
</entry>
<entry>
<title>Revert "docs: fix typos and grammar (ported from #1852 RST → MyST)"</title>
<updated>2026-05-06T14:16:23+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@andamasov.com</email>
</author>
<published>2026-05-06T14:16:23+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=7730d865c6a5792fdee3e3c3855a582557de7b70'/>
<id>urn:sha1:7730d865c6a5792fdee3e3c3855a582557de7b70</id>
<content type='text'>
</content>
</entry>
</feed>
