diff --git a/platform/projectModel-api/src/com/intellij/openapi/components/Storage.java b/platform/projectModel-api/src/com/intellij/openapi/components/Storage.java
index 35e23aaa54e2..d5c2353bba82 100644
--- a/platform/projectModel-api/src/com/intellij/openapi/components/Storage.java
+++ b/platform/projectModel-api/src/com/intellij/openapi/components/Storage.java
@@ -28,6 +28,9 @@ public @interface Storage {
   @NonNls String file() default "";
   StorageScheme scheme() default StorageScheme.DEFAULT;
 
+  /**
+   * If deprecated: Data will be removed on write. And ignored on read if (and only if) new storage exists.
+   */
   boolean deprecated() default false;
 
   /**