Merge pull request #2372 from matrix-org/jryans/clarify-cross-signing-examples

Clarify cross-signing examples

proposals/1756-cross-signing.md

@@ -216,12 +216,12 @@ response:
 }
 ```
 
-Similarly, the federation endpoints `GET /user/keys/query` and `POST
+Similarly, the federation endpoints `POST /user/keys/query` and `POST
 /user/devices/{userId}` will include the master and self-signing keys.  (It
 will not include the user-signing key because it is not intended to be visible
 to other users.)
 
-`POST /keys/query`
+`POST /user/keys/query`
 
 ``` json
 {
@@ -432,7 +432,8 @@ response:
       }
     }
   },
-  "master_key": {
+  "master_keys": {
+    "@alice:example.com": {
       "user_id": "@alice:example.com",
       "usage": ["master"],
       "keys": {
@@ -443,8 +444,10 @@ response:
           "ed25519:HIJKLMN": "base64+signature+of+master+key"
         }
       }
+    }
   },
-  "self_signing_key": {
+  "self_signing_keys": {
+    "@alice:example.com": {
       "user_id": "@alice:example.com",
       "usage": ["self_signing"],
       "keys": {
@@ -457,6 +460,7 @@ response:
       }
     }
   }
+}
 ```
 
 Similarly, the federation endpoints `GET /user/keys/query` and `POST