diff --git a/src/address/address.go b/src/address/address.go
index c30367e8..3960b783 100644
--- a/src/address/address.go
+++ b/src/address/address.go
@@ -1,3 +1,5 @@
+// Package address contains the types used by yggdrasil to represent IPv6 addresses or prefixes, as well as functions for working with these types.
+// Of particular importance are the functions used to derive addresses or subnets from a NodeID, or to get the NodeID and bitmask of the bits visible from an address, which is needed for DHT searches.
 package address
 
 import "github.com/yggdrasil-network/yggdrasil-go/src/crypto"
diff --git a/src/crypto/crypto.go b/src/crypto/crypto.go
index 55f26f74..6c10a2ef 100644
--- a/src/crypto/crypto.go
+++ b/src/crypto/crypto.go
@@ -1,3 +1,6 @@
+// Package crypto is a wrapper around packages under golang.org/x/crypto/, particulaly curve25519, ed25519, and nacl/box.
+// This is used to avoid explicitly importing and using these packages throughout yggdrasil.
+// It also includes the all-important NodeID and TreeID types, which are used to identify nodes in the DHT and in the spanning tree's root selection algorithm, respectively.
 package crypto
 
 /*
diff --git a/src/util/util.go b/src/util/util.go
index c73faf68..a7a54562 100644
--- a/src/util/util.go
+++ b/src/util/util.go
@@ -1,3 +1,5 @@
+// Package util contains miscellaneous utilities used by yggdrasil.
+// In particular, this includes a crypto worker pool, Cancellation machinery, and a sync.Pool used to reuse []byte.
 package util
 
 // These are misc. utility functions that didn't really fit anywhere else