diff --git a/ui/key/key.go b/ui/key/key.go
index e009089d..aa30d1dd 100644
--- a/ui/key/key.go
+++ b/ui/key/key.go
@@ -1,5 +1,12 @@
 // SPDX-License-Identifier: Unlicense OR MIT
 
+/*
+Package key implements key and text input handling.
+
+The HandlerOp operations is used for declaring key
+input handlers. Use the Queue interface from package
+input to receive events.
+*/
 package key
 
 import (
@@ -8,13 +15,21 @@ import (
 	"gioui.org/ui/internal/opconst"
 )
 
+// HandlerOp declares a handler ready for key events.
+// Key events are in general only delivered to the
+// focused key handler. Set the Focus flag to request
+// the focus.
 type HandlerOp struct {
 	Key   input.Key
 	Focus bool
 }
 
+// HideInputOp request that any on screen text input
+// be hidden.
 type HideInputOp struct{}
 
+// FocusEvent is sent when a handler gains or looses
+// focus.
 type FocusEvent struct {
 	Focus bool
 }