feat: flip swap mechanism — MD as primary, RST as override (Phase 1)

This is the first of three phases inverting the per-page swap mechanism
so MD becomes the canonical primary and RST becomes the rare override.

Phase 1 — file renames + conf.py exclude_patterns flip only:
- Rename docs/**/md-<stem>.md to docs/**/<stem>.md (drop md- prefix)
  for all 254 stems previously listed in docs/_swap.txt
- Rename docs/**/<stem>.rst to docs/**/rst-<stem>.rst (add rst- prefix)
  for the same 254 stems
- Repurpose docs/_swap.txt as docs/_rst_overrides.txt; initially empty
  comment-only since no pages need the RST fallback right now
- conf.py exclude_patterns flipped: rst-*.rst is now excluded by default
  instead of md-*.md
- conf.py runtime-artifact references updated to _rst_override_state.json
  and _md_exclude.txt (Phase 2 will rewrite swap_sources.py to produce
  these names; for now no swap script runs because overrides list is empty)

Phase 2 (next commit on this branch) will rewrite scripts/swap_sources.py
with inverted rename direction, delete scripts/import_myst.py + tests, and
update tests/test_swap_sources.py for the new semantics.

Phase 3 will be the cleanup pass and ready-for-review flip.

Generated by robots https://vyos.io

1 files changed, 0 insertions, 296 deletions

diff --git a/docs/configuration/protocols/md-babel.md b/docs/configuration/protocols/md-babel.md
deleted file mode 100644
index b03e9fa4..00000000
--- a/docs/configuration/protocols/md-babel.md
+++ /dev/null
@@ -1,296 +0,0 @@
-```{eval-rst}
-.. meta::
-   :description: The Babel routing protocol provides robust and efficient
-                 routing for wired and wireless mesh networks.
-   :keywords: babel, routing, protocol, wireless, mesh, network, metric,
-              ipv4, ipv6
-```
-
-(babel)=
-
-# Babel
-
-The Babel protocol provides robust and efficient routing for both wired and
-wireless mesh networks. By default, Babel uses hop-count metrics on wired links
-and a variant of Expected Transmission Count (ETX) on wireless links.
-Administrators can configure Babel to account for radio diversity,
-automatically compute link latency, and include that latency in the routing
-metric. {rfc}`8966` defines the Babel protocol.
-
-Babel is a dual-stack protocol. A single Babel instance routes both IPv4 and
-IPv6 traffic simultaneously.
-
-## General configuration
-
-VyOS does not require a specific command to start the Babel process. The system
-automatically starts the routing process when you configure the first
-Babel-enabled interface.
-
-```{cfgcmd} set protocols babel interface \<interface\>
-
-**Enable Babel routing on the specified interface.**
-
-The system immediately begins sending and receiving Babel packets on this
-interface.
-```
-
-## Optional configuration
-
-```{cfgcmd} set protocols babel parameters diversity
-
-**Enable radio-frequency diversity routing for the Babel process.**
-
-Enabling this feature is highly recommended for networks with many
-wireless nodes.
-
-:::{note}
-When you enable diversity routing, you should also configure the
-``diversity-factor`` and ``channel`` parameters.
-:::
-```
-
-```{cfgcmd} set protocols babel parameters diversity-factor \<1-256\>
-
-**Configure the multiplicative factor for diversity routing, in units of
-1/256.**
-
-Lower multiplicative factors give greater weight to diversity in route
-selection. The default value is 256, which disables diversity routing.
-On nodes with multiple independent radios, configure a value of 128 or less.
-```
-
-```{cfgcmd} set protocols babel parameters resend-delay \<20-655340\>
-
-**Configure the delay in milliseconds before the system resends an
-important request or update.**
-
-The default value is 2000 ms.
-```
-
-```{cfgcmd} set protocols babel parameters smoothing-half-life \<0-65534\>
-
-**Configure the time constant, in seconds, for the smoothing algorithm used
-to implement hysteresis.**
-
-Higher values reduce route oscillation but slightly increase convergence
-time. A value of 0 disables hysteresis and is suitable for wired networks.
-The default is 4 seconds.
-```
-
-## Interfaces configuration
-
-```{cfgcmd} set protocols babel interface \<interface\> type \<auto|wired|wireless\>
-
-**Configure the network type for the Babel-enabled interface.**
-
-Choose from the following:
-
-* ``auto``: Babel automatically detects if an interface is wired or
-  wireless.
-* ``wired``: Babel enables optimizations for wired interfaces.
-* ``wireless``: Babel disables optimizations suitable only for wired
-  interfaces. Specifying wireless is always correct, but may cause slower
-  convergence and increased routing traffic.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> split-horizon \<default|disable|enable\>
-
-**Configure the split-horizon routing behavior for the specified
-interface.**
-
-Use one of the following options:
-
-* ``default``: Babel automatically enables split-horizon on wired
-  interfaces and disables it on wireless interfaces.
-* ``enable``: Babel enables split-horizon on the interface. This
-  optimization should be used only on symmetric, transitive (wired)
-  networks.
-* ``disable``: Babel disables split-horizon on the interface. Disabling
-  split-horizon is always safe and correct.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> hello-interval \<20-655340\>
-
-**Configure the interval, in milliseconds, between scheduled hello messages
-on the specified interface.**
-
-On wired links, Babel detects link failures within two hello intervals.
-On wireless links, link quality is reestimated at each interval. The
-default is 4000 ms.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> update-interval \<20-655340\>
-
-**Configure the interval, in milliseconds, between scheduled routing
-updates on the specified interface.**
-
-Because Babel uses triggered updates extensively, you can increase this
-value on reliable links with minimal packet loss. The default is 20000 ms.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> rxcost \<1-65534\>
-
-**Configure the base receive cost for the specified interface.**
-
-Babel applies this value based on the configured network type:
-
-* ``wired``: The value is the routing cost advertised to neighboring
-  routers.
-* ``wireless``: The value is a multiplier used to compute the ETX
-  (Expected Transmission Count) reception cost.
-
-The default value is 256.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> rtt-decay \<1-256\>
-
-**Configure the decay factor for the exponential moving average of RTT
-samples, in units of 1/256.**
-
-Higher values discard older samples faster. The default value is 42.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> rtt-min \<1-65535\>
-
-**Configure the minimum RTT, in milliseconds, at which the cost to a
-neighbor begins to increase.**
-
-The additional cost is linear in (rtt - rtt-min). The default value is 10 ms.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> rtt-max \<1-65535\>
-
-**Configure the maximum RTT, in milliseconds, above which the cost to a
-neighbor stops increasing.**
-
-The default value is 120 ms.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> max-rtt-penalty \<0-65535\>
-
-**Configure the maximum cost added to a neighbor when RTT meets or exceeds
-rtt-max.**
-
-Setting this value to 0 disables RTT-based costs. The default value is 150.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> enable-timestamps
-
-**Configure adding timestamps to each Hello and IHU message to calculate
-RTT values.**
-
-Enabling timestamps is recommended for tunnel interfaces.
-```
-
-```{cfgcmd} set protocols babel interface \<interface\> channel \<1-254|interfering|noninterfering\>
-
-**Configure the channel identifier that diversity routing uses for the
-specified interface.**
-
-Interfaces interfere with each other based on the assigned channel
-identifier:
-
-* ``1–254``: The interface interferes with interfaces sharing the same
-  channel number and with interfaces configured as ``interfering``.
-* ``interfering``: The interface interferes with all others except those
-  configured as ``noninterfering``.
-* ``noninterfering``: The interface interferes only with itself.
-```
-
-## Redistribution configuration
-
-```{cfgcmd} set protocols babel redistribute \<ipv4|ipv6\> \<route source\>
-
-**Configure the redistribution of routing information from the specified
-route source into the Babel process.**
-
-The following route sources are available:
-
-* **ipv4:** ``bgp``, ``connected``, ``eigrp``, ``isis``, ``kernel``,
-  ``nhrp``, ``ospf``, ``rip``, ``static``
-* **ipv6:** ``bgp``, ``connected``, ``eigrp``, ``isis``, ``kernel``,
-  ``nhrp``, ``ospfv3``, ``ripng``, ``static``
-```
-
-```{cfgcmd} set protocols babel distribute-list \<ipv4|ipv6\> access-list \<in|out\> \<number\>
-
-**Configure global Babel route filtering using an access list.**
-
-Specify the direction in which the access list is applied:
-
-* ``in``: Filters incoming routes.
-* ``out``: Filters outgoing routes.
-```
-
-```{cfgcmd} set protocols babel distribute-list \<ipv4|ipv6\> interface \<interface\> access-list \<in|out\> \<number\>
-
-**Configure Babel route filtering on the specified interface using an
-access list.**
-
-Specify the direction in which the access list is applied:
-
-* ``in``: Filters incoming routes.
-* ``out``: Filters outgoing routes.
-```
-
-```{cfgcmd} set protocols babel distribute-list \<ipv4|ipv6\> prefix-list \<in|out\> \<name\>
-
-**Configure global Babel route filtering using a prefix list.**
-
-Specify the direction in which the prefix list is applied:
-
-* ``in``: Filters incoming routes.
-* ``out``: Filters outgoing routes.
-```
-
-```{cfgcmd} set protocols babel distribute-list \<ipv4|ipv6\> interface \<interface\> prefix-list \<in|out\> \<name\>
-
-**Configure Babel route filtering on the specified interface using a
-prefix list.**
-
-Specify the direction in which the prefix list is applied:
-
-* ``in``: Filters incoming routes.
-* ``out``: Filters outgoing routes.
-```
-
-## Configuration example
-
-### Basic two-node babel network
-
-**Goal:** The following example connects two routers (Node 1 and Node 2) via
-their eth0 interfaces and uses the Babel routing protocol to advertise
-(redistribute) each router's locally configured networks (represented by
-loopback addresses) to one another.
-
-**Node 1:**
-
-```none
-# Configure the loopback (local networks) and physical (eth0) addresses
-set interfaces loopback lo address 10.1.1.1/32
-set interfaces loopback lo address fd12:3456:dead:beef::1/128
-set interfaces ethernet eth0 address 192.168.1.1/24
-
-# Enable Babel on the physical link
-set protocols babel interface eth0 type wired
-
-# Instruct Babel to advertise (redistribute) the locally configured networks
-set protocols babel redistribute ipv4 connected
-set protocols babel redistribute ipv6 connected
-```
-
-**Node 2:**
-
-```none
-# Configure the loopback (local networks) and physical (eth0) addresses
-set interfaces loopback lo address 10.2.2.2/32
-set interfaces loopback lo address fd12:3456:beef:dead::2/128
-set interfaces ethernet eth0 address 192.168.1.2/24
-
-# Enable Babel on the physical link
-set protocols babel interface eth0 type wired
-
-# Tell Babel to advertise (redistribute) the locally configured networks
-set protocols babel redistribute ipv4 connected
-set protocols babel redistribute ipv6 connected
-```