diff --git a/util/eventlog/polite_json_formatter.go b/util/eventlog/polite_json_formatter.go
index 509f0871b..d206f5d99 100644
--- a/util/eventlog/polite_json_formatter.go
+++ b/util/eventlog/polite_json_formatter.go
@@ -7,6 +7,8 @@ import (
 	"github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/maybebtc/logrus"
 )
 
+// PoliteJSONFormatter marshals entries into JSON encoded slices (without
+// overwriting user-provided keys). How polite of it!
 type PoliteJSONFormatter struct{}
 
 func (f *PoliteJSONFormatter) Format(entry *logrus.Entry) ([]byte, error) {