diff --git a/zerver/openapi/zulip-2.0.yaml b/zerver/openapi/zulip-2.0.yaml
index 14347d6193..ef7b56b772 100644
--- a/zerver/openapi/zulip-2.0.yaml
+++ b/zerver/openapi/zulip-2.0.yaml
@@ -1,5 +1,8 @@
 # THIS FILE IS DEPRECATED! Please refer to zulip.yaml, which contains the new
 # specification (using OpenAPI 3.0).
+#
+# The current contents of this file should be reviewed and migrated to the new
+# zulip.yaml.
 
 # This file contains the Swagger UI configuration and API definitions
 # for the Zulip REST API.