diff --git a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
index 56f9f60f3ebe..0760a781ea33 100644
--- a/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
+++ b/nixos/doc/manual/from_md/release-notes/rl-2205.section.xml
@@ -746,6 +746,70 @@
false.
+
+
+ pkgs.makeDesktopItem has been refactored to
+ provide a more idiomatic API. Specifically:
+
+
+
+
+ All valid options as of FDO Desktop Entry specification
+ version 1.4 can now be passed in as explicit arguments
+
+
+
+
+ exec can now be null, for entries that
+ are not of type Application
+
+
+
+
+ mimeType argument is renamed to
+ mimeTypes for consistency
+
+
+
+
+ mimeTypes,
+ categories,
+ implements,
+ keywords, onlyShowIn
+ and notShowIn take lists of strings
+ instead of one string with semicolon separators
+
+
+
+
+ extraDesktopEntries renamed to
+ extraConfig for consistency
+
+
+
+
+ Actions should now be provided as an attrset
+ actions, the Actions
+ line will be autogenerated.
+
+
+
+
+ extraEntries is removed.
+
+
+
+
+ Additional validation is added both at eval time and at
+ build time.
+
+
+
+
+ See the vscode package for a more detailed
+ example.
+
+
diff --git a/nixos/doc/manual/release-notes/rl-2205.section.md b/nixos/doc/manual/release-notes/rl-2205.section.md
index 2994facffc97..2a931cd7fd6f 100644
--- a/nixos/doc/manual/release-notes/rl-2205.section.md
+++ b/nixos/doc/manual/release-notes/rl-2205.section.md
@@ -231,6 +231,18 @@ In addition to numerous new and upgraded packages, this release has the followin
pipewire-media-session is deprecated by upstream and not recommended, but can still be manually enabled by setting
`services.pipewire.media-session.enable` to `true` and `services.pipewire.wireplumber.enable` to `false`.
+- `pkgs.makeDesktopItem` has been refactored to provide a more idiomatic API. Specifically:
+ - All valid options as of FDO Desktop Entry specification version 1.4 can now be passed in as explicit arguments
+ - `exec` can now be null, for entries that are not of type Application
+ - `mimeType` argument is renamed to `mimeTypes` for consistency
+ - `mimeTypes`, `categories`, `implements`, `keywords`, `onlyShowIn` and `notShowIn` take lists of strings instead of one string with semicolon separators
+ - `extraDesktopEntries` renamed to `extraConfig` for consistency
+ - Actions should now be provided as an attrset `actions`, the `Actions` line will be autogenerated.
+ - `extraEntries` is removed.
+ - Additional validation is added both at eval time and at build time.
+
+ See the `vscode` package for a more detailed example.
+
## Other Notable Changes {#sec-release-22.05-notable-changes}