diff --git a/exchange/offline/offline.go b/exchange/offline/offline.go
index 2a7527f56c4ede436af226b06360295ea01b0d3e..5f7ef883550e25b81858c2dca2032dcd10e229e1 100644
--- a/exchange/offline/offline.go
+++ b/exchange/offline/offline.go
@@ -1,4 +1,6 @@
-package bitswap
+// package offline implements an object that implements the exchange
+// interface but returns nil values to every request.
+package offline
 
 import (
 	"errors"
diff --git a/exchange/offline/offline_test.go b/exchange/offline/offline_test.go
index b759a61ca3702e5c25e91b1028061d974ec64a6e..cc3f3ec82b96bcc9e2b8fdf1d1a7f57771c9c310 100644
--- a/exchange/offline/offline_test.go
+++ b/exchange/offline/offline_test.go
@@ -1,4 +1,4 @@
-package bitswap
+package offline
 
 import (
 	"testing"
diff --git a/net/swarm/swarm.go b/net/swarm/swarm.go
index 2f022db006c4f1208334b016823a6a539b26508c..6a50ecd00ccf45afbda4d371e7ce451a65890737 100644
--- a/net/swarm/swarm.go
+++ b/net/swarm/swarm.go
@@ -1,3 +1,5 @@
+// package swarm implements a connection muxer with a pair of channels
+// to synchronize all network communication.
 package swarm
 
 import (
diff --git a/routing/dht/handlers.go b/routing/dht/handlers.go
index fe628eeef578835566f6c08bd485c61e4d73a4b1..f7b074416aebb724f5303bfcfc618d29b80f637d 100644
--- a/routing/dht/handlers.go
+++ b/routing/dht/handlers.go
@@ -12,6 +12,7 @@ import (
 	ds "github.com/jbenet/go-ipfs/Godeps/_workspace/src/github.com/jbenet/go-datastore"
 )
 
+// The number of closer peers to send on requests.
 var CloserPeerCount = 4
 
 // dhthandler specifies the signature of functions that handle DHT messages.