docs: T8887: address review feedback and pre-existing lint debtdocs/t8887-phase1-batch1

- router-advert: reword base-interface description — the base interface
  provides the network portion of the advertised RA prefix (radvd
  Base6Interface), not the host bits; note the DHCPv6-PD use case
- route-map, ipsec_general: wrap five pre-existing overlong lines so the
  doc linter (which scans whole modified files) passes on touched files

🤖 Generated by [robots](https://vyos.io)

3 files changed, 14 insertions, 8 deletions

diff --git a/docs/configuration/policy/route-map.md b/docs/configuration/policy/route-map.md
index 1d49dfe3..524e7ec0 100644
--- a/docs/configuration/policy/route-map.md
+++ b/docs/configuration/policy/route-map.md
@@ -433,14 +433,18 @@ Set BGP weight attribute
 > - `local-as` - Well-known communities value NO_EXPORT_SUBCONFED 0xFFFFFF03
 > - `no-advertise` - Well-known communities value NO_ADVERTISE 0xFFFFFF02
 > - `no-export` - Well-known communities value NO_EXPORT 0xFFFFFF01
-> - `graceful-shutdown` - Well-known communities value GRACEFUL_SHUTDOWN 0xFFFF0000
+> - `graceful-shutdown` - Well-known communities value GRACEFUL_SHUTDOWN
+>   0xFFFF0000
 > - `accept-own` - Well-known communities value ACCEPT_OWN 0xFFFF0001
-> - `route-filter-translated-v4` - Well-known communities value ROUTE_FILTER_TRANSLATED_v4 0xFFFF0002
+> - `route-filter-translated-v4` - Well-known communities value
+>   ROUTE_FILTER_TRANSLATED_v4 0xFFFF0002
 > - `route-filter-v4` - Well-known communities value ROUTE_FILTER_v4 0xFFFF0003
-> - `route-filter-translated-v6` - Well-known communities value ROUTE_FILTER_TRANSLATED_v6 0xFFFF0004
+> - `route-filter-translated-v6` - Well-known communities value
+>   ROUTE_FILTER_TRANSLATED_v6 0xFFFF0004
 > - `route-filter-v6` - Well-known communities value ROUTE_FILTER_v6 0xFFFF0005
 > - `llgr-stale` - Well-known communities value LLGR_STALE 0xFFFF0006
 > - `no-llgr` - Well-known communities value NO_LLGR 0xFFFF0007
-> - `accept-own-nexthop` - Well-known communities value accept-own-nexthop 0xFFFF0008
+> - `accept-own-nexthop` - Well-known communities value accept-own-nexthop
+>   0xFFFF0008
 > - `blackhole` - Well-known communities value BLACKHOLE 0xFFFF029A
 > - `no-peer` - Well-known communities value NOPEER 0xFFFFFF04
diff --git a/docs/configuration/service/router-advert.md b/docs/configuration/service/router-advert.md
index 9a70067e..7f0ba895 100644
--- a/docs/configuration/service/router-advert.md
+++ b/docs/configuration/service/router-advert.md
@@ -62,9 +62,10 @@ from DHCPv6-PD.
 ```{cfgcmd} set service router-advert interface \<interface\> prefix \<prefix\> base-interface \<interface\>
 
 The advertised prefix is combined with the IPv6 address of the specified
-interface (for example, a WAN interface) to derive the advertised prefix's
-host bits. This option is only allowed together with the wildcard prefix
-`::/64`.
+interface (for example, a WAN interface) so that the network portion of
+the RA prefix follows that interface's current IPv6 address. This option
+is only allowed together with the wildcard prefix `::/64`, and is the
+typical way to re-advertise a DHCPv6-PD-assigned prefix.
 ```
 
 ```{eval-rst}
diff --git a/docs/configuration/vpn/ipsec/ipsec_general.md b/docs/configuration/vpn/ipsec/ipsec_general.md
index 0a79601f..e9c5ee4c 100644
--- a/docs/configuration/vpn/ipsec/ipsec_general.md
+++ b/docs/configuration/vpn/ipsec/ipsec_general.md
@@ -383,7 +383,8 @@ Options
 
 ### IKEv2 Retransmission
 
-If the peer does not respond on DPD packet, the router starts retransmission procedure.
+If the peer does not respond on DPD packet, the router starts retransmission
+procedure.
 
 The following formula is used to calculate the timeout: