From c041642546cd00cf451ef7d3c22a587c8eaaa152 Mon Sep 17 00:00:00 2001
From: Yusef Napora <yusef@protocol.ai>
Date: Fri, 8 May 2020 10:12:20 -0400
Subject: [PATCH] add note about opp. graft threshold

---
 gossipsub.go | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/gossipsub.go b/gossipsub.go
index bb853e6..d084325 100644
--- a/gossipsub.go
+++ b/gossipsub.go
@@ -129,7 +129,8 @@ var (
 
 	// GossipSubOpportunisticGraftTicks is the number of heartbeat ticks for attempting to improve the mesh
 	// with opportunistic grafting. Every GossipSubOpportunisticGraftTicks we will attempt to select some
-	// high-scoring mesh peers to replace lower-scoring ones.
+	// high-scoring mesh peers to replace lower-scoring ones, if the median score of our mesh peers falls
+	// below a threshold (see https://godoc.org/github.com/libp2p/go-libp2p-pubsub#PeerScoreThresholds).
 	GossipSubOpportunisticGraftTicks uint64 = 60
 
 	// GossipSubOpportunisticGraftPeers is the number of peers to opportunistically graft.