diff --git a/cluster/gossip.proto b/cluster/gossip.proto
index 2effa65e..b4dfc0c4 100644
--- a/cluster/gossip.proto
+++ b/cluster/gossip.proto
@@ -14,12 +14,14 @@ message GossipResponse {
   GossipState state = 1;
 }
 
-//two GossipState objects can be merged
-//key + member_id gets it's own entry, if collision, highest version is selected
+//string key is member id
+//GossipState is the state of that member
 message GossipState {
   map<string, GossipMemberState>  members = 1;
 }
 
+//string key is the key of the gossip value, e.g. "heartbeat"
+//GossipKeyValue is the value of that key
 message GossipMemberState {
   map<string, GossipKeyValue> values = 1;
 }