Commit suggestion

di · di · commit 55f3ddeae1e9 · 2025-01-14T20:15:00.000Z
diff --git a/source/specifications/core-metadata.rst b/source/specifications/core-metadata.rst
@@ -797,8 +797,10 @@ Examples::
 Deprecated Fields
 =================
 
-Deprecated fields are valid metadata fields for any metadata version. Tools
-SHOULD warn users when deprecated fields are used.
+Deprecated fields should be avoided, but they are valid metadata fields. They
+may be removed in future versions of the core metadata standard (at which point
+they will only be valid in files that specify a metadata version prior to the
+removal). Tools SHOULD warn users when deprecated fields are used.
 
 .. _home-page-optional:
 .. _core-metadata-home-page:
