diff --git a/docs/index.md b/docs/index.md
index 9b49dbaf..42ec7ebe 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -5,6 +5,12 @@ that are managed by
 [Argo CD](https://github.com/argoproj/argo-cd).
 
 !!!warning "A note on the current status"
+    There has been a major transition from an annotation-based configuration to a
+    CRD-based configuration with the v1.0.0 release. This documentation covers
+    the modern, CRD-based configuration for versions v1.x. For the legacy,
+    annotation-based configuration for versions v0.x (e.g. `0.17.0`), please
+    consult the documentation for the respective version.
+
     Argo CD Image Updater is under active development.
 
     You are welcome to test it out on non-critical environments, and of