diff --git a/docs/p2p.md b/docs/p2p.md
index 75160f48..c9f0da82 100644
--- a/docs/p2p.md
+++ b/docs/p2p.md
@@ -4,6 +4,14 @@ Peer-to-peer (P2P) synchronisation transfers Vault data between LiveSync devices
 
 For the procedure for the first and additional devices, see [Set up peer-to-peer synchronisation](setup_p2p.md). For connection problems, see [Peer-to-Peer Synchronisation Tips](tips/p2p-sync-tips.md).
 
+## Updating a P2P group
+
+The unreleased transport update uses Trystero 0.26.0, whose data format is
+incompatible with the previous transport. Update every device in the P2P
+group, including CLI and WebPeer clients, before resuming P2P synchronisation.
+Keeping the same Group ID, passphrase, and relay settings does not make mixed
+transport versions compatible.
+
 ## Connection model
 
 ```mermaid
diff --git a/updates.md b/updates.md
index 93c3d030..0743ac10 100644
--- a/updates.md
+++ b/updates.md
@@ -12,6 +12,18 @@ Earlier releases remain available in the 1.0 release history, the 1.0 preview hi
 
 ## Unreleased
 
+### Improved
+
+#### P2P synchronisation
+
+- P2P connections include upstream improvements to peer discovery after relay
+  reconnection, recovery from missed signalling messages, and stale connections
+  after rejoining or waiting. Connection offers are created on demand to reduce
+  idle resource use.
+    - Update every device in the P2P group, including CLI and WebPeer clients,
+      before resuming P2P synchronisation. The updated transport uses Trystero
+      0.26.0 and cannot exchange data with the previous transport.
+
 ## 1.0.45
 
 5th November, 2026