diff --git a/crates/tor-error/src/lib.rs b/crates/tor-error/src/lib.rs
index d18be5060..cea2f7a7a 100644
--- a/crates/tor-error/src/lib.rs
+++ b/crates/tor-error/src/lib.rs
@@ -224,9 +224,14 @@ pub enum ErrorKind {
     /// something.
     ///
     /// This error can happen if the host you're trying to connect to isn't
-    /// responding to traffic. It can also happen if an exit is overloaded, and
+    /// responding to traffic.
+    /// It can also happen if an exit, or hidden service, is overloaded, and
     /// unable to answer your replies in a timely manner.
     ///
+    /// And it might simply mean that the Tor network itself
+    /// (including possibly relays, or hidden service introduction or rendezvous points)
+    /// is not working properly
+    ///
     /// In either case, trying later, or on a different circuit, might help.
     //
     // TODO: Say that this is distinct from the case where the exit _tells you_