diff --git a/docs/changelog.rst b/docs/changelog.rst
index e0e19101b..aa544bcac 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -74,9 +74,12 @@ For plugin developers:
   is almost identical apart from the name change. Again, we'll re-export at the
   old location (with a deprecation warning) for backwards compatibility, but
   might stop doing this in a future release.
-* ``beets.util.command_output`` now returns a named tuple of stdout and stderr
-  instead of only returning stdout. stdout can be accessed as a simple
-  attribute.
+* ``beets.util.command_output`` now returns a named tuple containing both the
+  standard output and the standard error data instead of just stdout alone.
+  Client code will need to access the ``stdout`` attribute on the return
+  value.
+  Thanks to :user:`zsinskri`.
+  :bug:`3329`
 
 For packagers: