diff --git a/basis/channels/channels-docs.factor b/basis/channels/channels-docs.factor
index 521a4a4ae2..b6ddc299e5 100644
--- a/basis/channels/channels-docs.factor
+++ b/basis/channels/channels-docs.factor
@@ -33,3 +33,14 @@ HELP: from
 " It will block the calling thread until there is data in the channel." 
 }
 { $see-also <channel> to } ;
+
+ARTICLE: "channels" "Channels"
+"The " { $vocab-link "channels" } " vocabulary provides a simple abstraction to send and receive objects." $nl
+"Opening a channel:"
+{ $subsection <channel> }
+"Sending a message:"
+{ $subsection to }
+"Receiving a message:"
+{ $subsection from } ;
+
+ABOUT: "channels"