diff --git a/openconn/openconn.go b/openconn/openconn.go
index 301ed27..bf32e3d 100644
--- a/openconn/openconn.go
+++ b/openconn/openconn.go
@@ -1,3 +1,8 @@
+// openconn provides a basic context.Context object to be used with gaio.Watcher
+// the context carries two channels, InChan and OutChan, which are used by menuHandler
+// and doorHandler to read input from the remote connection
+// TODO: decide whether or not we'll actuallly need OutChan - possibly for maintaining
+// output writes in order and/or ensuring output is delivered exactly once
 package openconn
 
 import (