diff --git a/src/api/tangles.rs b/src/api/tangles.rs
index c72d525..cfca04e 100644
--- a/src/api/tangles.rs
+++ b/src/api/tangles.rs
@@ -1,4 +1,5 @@
-//! Take a message reference and return a stream of all messages in the thread.
+//! Take a reference to the root message of a thread and return a stream of all
+//! messages in the thread. This includes the root message and all replies.
 //!
 //! Implements the following methods:
 //!