diff --git a/iris/prelude/options.v b/iris/prelude/options.v
index 39f1f4228680cbd453e59cf2108ac7fea6a6e0c2..80f9b75bf13501f32ffed25321e80a669093a893 100644
--- a/iris/prelude/options.v
+++ b/iris/prelude/options.v
@@ -1,4 +1,10 @@
-(** Coq configuration for Iris (not meant to leak to clients) *)
+(** Coq configuration for Iris (not meant to leak to clients).
+If you are a user of Iris, note that importing this file means
+you are implicitly opting-in to every new option we will add here
+in the future. We are *not* guaranteeing any kind of stability here.
+Instead our advice is for you to have your own options file; then
+you can re-export the Iris file there but if we ever add an option
+you disagree with you can easily overwrite it in one central location. *)
 (* Everything here should be [Export Set], which means when this
 file is *imported*, the option will only apply on the import site
 but not transitively. *)