diff --git a/registry/watcher.go b/registry/watcher.go
index c26cc04d..eeb6e246 100644
--- a/registry/watcher.go
+++ b/registry/watcher.go
@@ -1,10 +1,15 @@
 package registry
 
+// Watcher is an interface that returns updates
+// about services within the registry.
 type Watcher interface {
+	// Next is a blocking call
 	Next() (*Result, error)
 	Stop()
 }
 
+// Result is returned by a call to Next on
+// the watcher. Actions can be create, update, delete
 type Result struct {
 	Action  string
 	Service *Service