diff --git a/src/core/client/stream/local/local.graphql b/src/core/client/stream/local/local.graphql
index 088e86390..45887aff2 100644
--- a/src/core/client/stream/local/local.graphql
+++ b/src/core/client/stream/local/local.graphql
@@ -20,7 +20,10 @@ type AuthPopup {
 }
 
 extend type Comment {
+  # pending is true during the optimistic response.
   pending: Boolean
+  # localReplies contains only comments created by the user
+  # on the ultimate threading level.
   localReplies: [Comment!]
 }