diff --git a/deltachat-jsonrpc/src/api/types/qr.rs b/deltachat-jsonrpc/src/api/types/qr.rs
index 7082a7381..28dd87b0a 100644
--- a/deltachat-jsonrpc/src/api/types/qr.rs
+++ b/deltachat-jsonrpc/src/api/types/qr.rs
@@ -38,11 +38,15 @@ pub enum QrObject {
     AskJoinBroadcast {
         /// Chat name.
         broadcast_name: String,
-        /// Group ID.
+        /// A string of random characters,
+        /// uniquely identifying this broadcast channel in the database.
+        /// Called `grpid` for historic reasons:
+        /// The id of multi-user chats is always called `grpid` in the database
+        /// because groups were once the only multi-user chats.
         grpid: String,
-        /// ID of the contact.
+        /// ID of the contact who owns the channel and created the QR code.
         contact_id: u32,
-        /// Fingerprint of the contact key as scanned from the QR code.
+        /// Fingerprint of the contact's key as scanned from the QR code.
         fingerprint: String,
 
         authcode: String,
diff --git a/src/qr.rs b/src/qr.rs
index 0a1d1e6e2..0bbf4de6e 100644
--- a/src/qr.rs
+++ b/src/qr.rs
@@ -96,10 +96,10 @@ pub enum Qr {
         /// because groups were once the only multi-user chats.
         grpid: String,
 
-        /// The contact id of the inviter
+        /// ID of the contact who owns the channel and created the QR code.
         contact_id: ContactId,
 
-        /// The PGP fingerprint of the inviter
+        /// Fingerprint of the contact's key as scanned from the QR code.
         fingerprint: Fingerprint,
 
         /// The AUTH code from the secure-join protocol,