diff --git a/UPGRADING.md b/UPGRADING.md
index 83dddbca..94540fa6 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -50,7 +50,7 @@
     * If you need absolute control more than the above, you can subclass `AppCastHelper` and override methods: `SetupAppCastHelper`, `DownloadAppCast`, and `FilterUpdates`. This probably is not necessary, however, and you can do what you want through the interfaces, most likely.
   * `AppCastHelper.SetupAppCastHelper` signature is now `SetupAppCastHelper(IAppCastDataDownloader dataDownloader, string castUrl, string? installedVersion, ISignatureVerifier? signatureVerifier, ILogger? logWriter = null)` (note: no longer takes a `Configuration` object)
 * Renamed `AppCastItem.OperatingSystemString` to `OperatingSystem`
-* XML app casts write `version`, `shortVersion`, and `criticalUpdate` to the `<item>` tag and the `<enclosure>` (for backwards/Sparkle compat).
+* XML app casts write `version`, `shortVersion`, and `criticalUpdate` to the `<item>` tag and the `<enclosure>` (both for backwards/Sparkle compat; we'd rather not write to `<enclosure>` but we don't want to break anyone that updates their app cast gen without updating the main library).
   * If both the overall `<item>` and the `<enclosure>` have this data, the info from the `<item>` is prioritized.
   * JSON app casts are not affected.