1 files changed, 237 insertions, 100 deletions
diff --git a/docs/_swap.txt b/docs/_swap.txt
index 43e32cc5..3ffcdaf6 100644
--- a/docs/_swap.txt
+++ b/docs/_swap.txt
@@ -2,124 +2,261 @@
 # One page stem per line (relative to docs/, no extension)
 # Pages listed here will render from MD instead of RST at build time.
 #
-# Example:
-#   configuration/firewall/zone
+# Default: every imported md-*.md page is listed below so MD is served
+# by default. To revert a specific page back to RST, remove its line
+# (or comment it out).
 
-# Visual-validated canaries (<5% BackstopJS diff vs RST reference, 2026-04-23)
-vpp/configuration/interfaces/xconnect
-vpp/configuration/interfaces/bonding
+404
+automation/cloud-init
 automation/command-scripting
+automation/index
+automation/terraform/index
+automation/terraform/terraformAWS
+automation/terraform/terraformAZ
+automation/terraform/terraformGoogle
+automation/terraform/terraformvSphere
+automation/vyos-ansible
+automation/vyos-api
+automation/vyos-govyos
+automation/vyos-napalm
+automation/vyos-netmiko
+automation/vyos-pyvyos
+automation/vyos-salt
+cli
 configexamples/ansible
-operation/raid
-vpp/troubleshooting
-contributing/debugging
+configexamples/autotest/DHCPRelay_through_GRE/DHCPRelay_through_GRE
+configexamples/autotest/L3VPN_EVPN/L3VPN_EVPN
+configexamples/autotest/OpenVPN_with_LDAP/OpenVPN_with_LDAP
+configexamples/autotest/Wireguard/Wireguard
+configexamples/autotest/tunnelbroker/tunnelbroker
+configexamples/azure-vpn-bgp
+configexamples/azure-vpn-dual-bgp
 configexamples/bgp-ipv6-unnumbered
-configuration/firewall/global-options
-configuration/vpn/ipsec/remoteaccess_ipsec
-vpp/configuration/ipfix
-automation/vyos-govyos
+configexamples/dmvpn-dualhub-dualcloud
+configexamples/firewall
+configexamples/fwall-and-bridge
+configexamples/fwall-and-vrf
+configexamples/ha
+configexamples/index
+configexamples/inter-vrf-routing-vrf-lite
+configexamples/ipsec-cisco-policy-based
+configexamples/ipsec-cisco-route-based
+configexamples/ipsec-pa-route-based
+configexamples/l3vpn-hub-and-spoke
 configexamples/lac-lns
+configexamples/nmp
+configexamples/ospf-unnumbered
+configexamples/policy-based-ipsec-and-firewall
+configexamples/pppoe-ipv6-basic
+configexamples/qos
 configexamples/segment-routing-isis
-vpp/configuration/interfaces/gre
-contributing/development
-vpp/configuration/interfaces/vxlan
-configuration/firewall/groups
-configuration/firewall/ipv6
-vpp/configuration/interfaces/loopback
+configexamples/site-2-site-cisco
+configexamples/wan-load-balancing
 configexamples/zone-policy
-installation/bare-metal
-troubleshooting/monitoring
-vpp/configuration/dataplane/memory
-configuration/policy/examples
-configexamples/policy-based-ipsec-and-firewall
-vpp/configuration/interfaces/ipip
+configuration/container/index
 configuration/firewall/bridge
+configuration/firewall/flowtables
+configuration/firewall/global-options
+configuration/firewall/groups
+configuration/firewall/index
+configuration/firewall/ipv4
+configuration/firewall/ipv6
+configuration/firewall/zone
+configuration/highavailability/index
+configuration/index
+configuration/interfaces/bonding
+configuration/interfaces/bridge
+configuration/interfaces/dummy
+configuration/interfaces/ethernet
+configuration/interfaces/geneve
+configuration/interfaces/index
+configuration/interfaces/l2tpv3
+configuration/interfaces/loopback
+configuration/interfaces/macsec
+configuration/interfaces/openvpn
+configuration/interfaces/openvpn-examples
+configuration/interfaces/pppoe
+configuration/interfaces/pseudo-ethernet
+configuration/interfaces/sstp-client
+configuration/interfaces/tunnel
+configuration/interfaces/virtual-ethernet
+configuration/interfaces/vti
+configuration/interfaces/vxlan
+configuration/interfaces/wireguard
+configuration/interfaces/wireless
+configuration/interfaces/wwan
+configuration/loadbalancing/haproxy
+configuration/loadbalancing/index
+configuration/loadbalancing/wan
+configuration/nat/cgnat
+configuration/nat/index
+configuration/nat/nat44
+configuration/nat/nat64
+configuration/nat/nat66
 configuration/pki/index
-vpp/configuration/acl
-vpp/description
-automation/vyos-ansible
-contributing/issues-features
-installation/install
-vpp/configuration/dataplane/interface
-vpp/configuration/dataplane/buffers
-vpp/requirements
-configexamples/index
-automation/vyos-napalm
-quick-start
-vpp/configuration/dataplane/cpu
-automation/vyos-netmiko
-vpp/configuration/dataplane/ipsec
-configexamples/nmp
-vpp/configuration/dataplane/logging
-vpp/configuration/sflow
-operation/upgrade-recovery
-vpp/configuration/dataplane/unix
-configuration/vpn/rsa-keys
-vpp/configuration/dataplane/lcp
-vpp/configuration/dataplane/ipv6
-vpp/configuration/interfaces/index
-troubleshooting/terminal
-vpp/configuration/nat/index
-contributing/cla
-configexamples/dmvpn-dualhub-dualcloud
-vpp/configuration/dataplane/l2learn
-vpp/limitations
+configuration/policy/access-list
+configuration/policy/as-path-list
+configuration/policy/community-list
+configuration/policy/examples
+configuration/policy/extcommunity-list
+configuration/policy/index
+configuration/policy/large-community-list
+configuration/policy/local-route
+configuration/policy/prefix-list
+configuration/policy/route
+configuration/policy/route-map
+configuration/protocols/arp
+configuration/protocols/babel
+configuration/protocols/bfd
+configuration/protocols/bgp
+configuration/protocols/failover
+configuration/protocols/igmp-proxy
+configuration/protocols/index
+configuration/protocols/isis
+configuration/protocols/mpls
+configuration/protocols/multicast
+configuration/protocols/openfabric
+configuration/protocols/ospf
+configuration/protocols/pim
+configuration/protocols/pim6
+configuration/protocols/rip
+configuration/protocols/rpki
+configuration/protocols/segment-routing
+configuration/protocols/static
+configuration/protocols/traffic-engineering
+configuration/service/broadcast-relay
+configuration/service/config-sync
+configuration/service/conntrack-sync
+configuration/service/console-server
+configuration/service/dhcp-relay
+configuration/service/dhcp-server
+configuration/service/dns
+configuration/service/eventhandler
+configuration/service/https
 configuration/service/index
-configuration/system/index
-troubleshooting/system
-troubleshooting/interfaces
-configuration/interfaces/index
-configuration/index
+configuration/service/ipoe-server
+configuration/service/lldp
+configuration/service/mdns
+configuration/service/monitoring
+configuration/service/ntp
+configuration/service/pppoe-server
+configuration/service/router-advert
+configuration/service/salt-minion
 configuration/service/snmp
-configexamples/firewall
-configuration/policy/index
-automation/terraform/index
-installation/virtual/docker
+configuration/service/ssh
+configuration/service/suricata
+configuration/service/tftp-server
+configuration/service/webproxy
+configuration/system/acceleration
+configuration/system/conntrack
+configuration/system/console
+configuration/system/default-route
+configuration/system/flow-accounting
+configuration/system/frr
+configuration/system/host-name
+configuration/system/index
+configuration/system/ip
+configuration/system/ipv6
+configuration/system/lcd
+configuration/system/login
+configuration/system/name-server
+configuration/system/option
+configuration/system/proxy
+configuration/system/sflow
 configuration/system/sysctl
-vpp/index
+configuration/system/syslog
+configuration/system/task-scheduler
+configuration/system/time-zone
+configuration/system/updates
+configuration/system/watchdog
+configuration/trafficpolicy/index
+configuration/vpn/dmvpn
 configuration/vpn/index
-contributing/index
-vpp/configuration/interfaces/bridge
 configuration/vpn/ipsec/index
+configuration/vpn/ipsec/ipsec_general
+configuration/vpn/ipsec/remoteaccess_ipsec
+configuration/vpn/ipsec/site2site_ipsec
+configuration/vpn/ipsec/troubleshooting_ipsec
+configuration/vpn/l2tp
+configuration/vpn/openconnect
+configuration/vpn/pptp
+configuration/vpn/rsa-keys
+configuration/vpn/sstp
+configuration/vrf/index
+contributing/build-vyos
+contributing/cla
+contributing/debugging
+contributing/development
+contributing/index
+contributing/issues-features
+contributing/testing
+contributing/upstream-packages
+coverage
+documentation
+index
+installation/bare-metal
+installation/cloud/aws
+installation/cloud/azure
+installation/cloud/gcp
+installation/cloud/index
+installation/cloud/oracle
+installation/image
+installation/index
+installation/install
+installation/secure-boot
+installation/update
+installation/virtual/docker
+installation/virtual/eve-ng
+installation/virtual/gns3
+installation/virtual/index
+installation/virtual/libvirt
 installation/virtual/proxmox
-configexamples/fwall-and-bridge
-configexamples/wan-load-balancing
-vpp/configuration/nat/nat44
 installation/virtual/vmware
-installation/cloud/index
-automation/vyos-pyvyos
-contributing/testing
-configuration/policy/route
-configuration/loadbalancing/index
-configuration/vpn/ipsec/troubleshooting_ipsec
 introducing/about
-installation/secure-boot
-404
-configexamples/ospf-unnumbered
 introducing/history
-operation/password-recovery
+operation/boot-options
 operation/index
-automation/index
-index
+operation/information
+operation/password-recovery
+operation/raid
+operation/upgrade-recovery
+quick-start
+troubleshooting/connectivity
 troubleshooting/index
-installation/virtual/gns3
-operation/boot-options
-installation/index
-configuration/nat/index
-vpp/configuration/index
+troubleshooting/interfaces
+troubleshooting/monitoring
+troubleshooting/system
+troubleshooting/terminal
+vpp/configuration/acl
+vpp/configuration/dataplane/buffers
+vpp/configuration/dataplane/cpu
 vpp/configuration/dataplane/index
-configuration/protocols/index
-installation/virtual/eve-ng
-configexamples/site-2-site-cisco
-contributing/upstream-packages
-
-# Newly added 2026-04-29 (post cfgcmd/opcmd single-line body fix,
-# BackstopJS <5%)
-configuration/policy/as-path-list
-configuration/policy/community-list
-configuration/policy/extcommunity-list
-configuration/policy/large-community-list
-configuration/policy/local-route
-configuration/policy/prefix-list
-configuration/service/salt-minion
-configuration/system/updates
+vpp/configuration/dataplane/interface
+vpp/configuration/dataplane/ipsec
+vpp/configuration/dataplane/ipv6
+vpp/configuration/dataplane/l2learn
+vpp/configuration/dataplane/lcp
+vpp/configuration/dataplane/logging
+vpp/configuration/dataplane/memory
+vpp/configuration/dataplane/system
+vpp/configuration/dataplane/unix
+vpp/configuration/index
+vpp/configuration/interfaces/bonding
+vpp/configuration/interfaces/bridge
+vpp/configuration/interfaces/gre
+vpp/configuration/interfaces/index
+vpp/configuration/interfaces/ipip
+vpp/configuration/interfaces/loopback
+vpp/configuration/interfaces/vxlan
+vpp/configuration/interfaces/xconnect
+vpp/configuration/ipfix
+vpp/configuration/ipsec
+vpp/configuration/nat/cgnat
+vpp/configuration/nat/index
+vpp/configuration/nat/nat44
+vpp/configuration/sflow
+vpp/description
+vpp/index
+vpp/limitations
+vpp/requirements
+vpp/troubleshooting