From 9dbcc14e5e42029bbba2afd87bb200454a292006 Mon Sep 17 00:00:00 2001
From: Marc Jakobi <marc.jakobi@tiko.energy>
Date: Mon, 17 Jun 2024 19:57:29 +0200
Subject: [PATCH] docs(readme): add note on having to set `opt = true`

---
 README.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ac1de62..db39d11 100644
--- a/README.md
+++ b/README.md
@@ -65,8 +65,15 @@ and you are good to go!
 
 ### Via `rocks.toml`
 
-With this module installed, you can add the following fields to a `[plugins]` entry
-in your `rocks.toml`:
+With this module installed, you can add the fields that tell `rocks-lazy.nvim`
+how to lazy-load to a `[plugins]` entry in your `rocks.toml`.
+
+> [!IMPORTANT]
+>
+> Because rocks.nvim currently does not have an API to hook into plugin loading[^1],
+> you must set `opt = true` for any plugins you want to lazy-load.
+
+[^1]: This may change as rocks.nvim matures.
 
 #### `event`