diff --git a/crates/arti-hyper/examples/hyper.rs b/crates/arti-hyper/examples/hyper.rs
index c9bcf8540..2f72a3cb5 100644
--- a/crates/arti-hyper/examples/hyper.rs
+++ b/crates/arti-hyper/examples/hyper.rs
@@ -1,3 +1,4 @@
+/// TODO this ought to support https!
 use arti_hyper::*;
 
 use anyhow::Result;
diff --git a/crates/arti-hyper/src/lib.rs b/crates/arti-hyper/src/lib.rs
index 642152d33..25fb3d612 100644
--- a/crates/arti-hyper/src/lib.rs
+++ b/crates/arti-hyper/src/lib.rs
@@ -1,4 +1,7 @@
 //! High-level layer for making http(s) requests the Tor network as a client.
+//!
+//! Work-in-progress.
+//! This is **not suitable for use** right now because it does not support HTTPs.
 
 #![deny(missing_docs)]
 #![warn(noop_method_call)]