add docs to PeerPicker
diff --git a/peers.go b/peers.go
index 4644640..dfaf5df 100644
--- a/peers.go
+++ b/peers.go
@@ -35,6 +35,9 @@
 // PeerPicker is the interface that must be implemented to locate
 // the peer that owns a specific key.
 type PeerPicker interface {
+	// PickPeer returns the peer that owns the specific key
+	// and true to indicate that a remote peer was nominated.
+	// It returns nil, false if the key owner is the current peer.
 	PickPeer(key string) (peer ProtoGetter, ok bool)
 }