document: put user in commit message trailer

1 files changed, 3 insertions, 2 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 4e07e8a..78912fa 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -558,8 +558,9 @@ paths:
       summary: Who wrote what
       description: |
         The document's changes, newest first: each with when (its writer's clock, Unix
-        ms; 0 for a remake's snapshot), the node that made it (`node`, its node ID) and,
-        for a write through the API, the user it was made for (`user`), and the store
+        ms; 0 for a remake's snapshot), the node that committed it (`node`, its node
+        ID) and, for a write through the API, the user at that node who wrote it
+        (`user`, from the message's `User:` trailer), and the store
         paths it touched (a list's items by index). Every node holds every change, so
         any node answers for the whole swarm, as far as it has synced; history before
         the last remake is gone with it (`remakes.md`). Changes made before nodes