move keepalive and firewall to paths

1 files changed, 5 insertions, 2 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 58faa9c..8919ca6 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -886,7 +886,10 @@ paths:
     put:
       tags: [Debug]
       summary: Replace the firewall rules
-      description: Drops messages from (`inbound`) or to (`outbound`) these peers, like a lossy network.
+      description: |
+        Drops messages from (`inbound`) or to (`outbound`) these peers (node IDs), like a
+        lossy network: everything, at every address they proved themselves at, including
+        WHO/ME and PING/PONG (applied in the paths layer).
       requestBody:
         required: true
         content:
@@ -1225,7 +1228,7 @@ components:
           description: WHO and ME, counted under the address they went to or came from (so only in the totals).
         paths:
           $ref: '#/components/schemas/Counter'
-          description: PING and PONG, counted under the address (so only in the totals).
+          description: PING and PONG; the paths layer's own PINGs counted under the address (so only in the totals).
 
     Traffic:
       type: object