diff --git a/extra/readline/readline-docs.factor b/extra/readline/readline-docs.factor
index 22af8787cc..f1082de954 100644
--- a/extra/readline/readline-docs.factor
+++ b/extra/readline/readline-docs.factor
@@ -25,8 +25,11 @@ HELP: set-completion
 } ;
 
 ARTICLE: "readline" "Readline"
-{ $vocab-link "readline" }
-;
+"The " { $vocab-link "readline" } " vocabulary binds to the C readline library and provides Emacs-style key bindings for editing text. Currently, it only works from the non-graphical UI." $nl
 
+"To read a line:"
+{ $subsections readline }
+"To set a completion hook:"
+{ $subsections set-completion } ;
 
 ABOUT: "readline"