diff --git a/src/libstd/net.rs b/src/libstd/net.rs
index 230fb4b616d00..ca1cc1235961a 100644
--- a/src/libstd/net.rs
+++ b/src/libstd/net.rs
@@ -8,7 +8,17 @@
 // option. This file may not be copied, modified, or distributed
 // except according to those terms.
 
-//! Top-level module for network-related functionality
+/*!
+Top-level module for network-related functionality.
+
+Basically, including this module gives you:
+
+* `net_tcp`
+* `net_ip`
+* `net_url`
+
+See each of those three modules for documentation on what they do.
+*/
 
 pub use tcp = net_tcp;
 pub use ip = net_ip;