diff --git a/docs/changelog.rst b/docs/changelog.rst
index fd37f992e..dd597d933 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -31,8 +31,9 @@ New features:
 * A new :ref:`hardlink` config option instructs the importer to create hard
   links on filesystems that support them. Thanks to :user:`jacobwgillespie`.
   :bug:`2445`
-* :doc:`/plugins/embedart` by default now asks for confirmation before
-  embedding art into music files. Thanks to :user:`Stunner`. :bug:`1999`
+* :doc:`/plugins/embedart`: The explicit ``embedart`` command now asks for
+  confirmation before embedding art into music files. Thanks to
+  :user:`Stunner`. :bug:`1999`
 * You can now run beets by typing `python -m beets`. :bug:`2453`
 * A new :doc:`/plugins/kodiupdate` lets you keep your Kodi library in sync
   with beets. Thanks to :user:`Pauligrinder`. :bug:`2411`
diff --git a/docs/plugins/embedart.rst b/docs/plugins/embedart.rst
index 717bfb8e2..68ea0f664 100644
--- a/docs/plugins/embedart.rst
+++ b/docs/plugins/embedart.rst
@@ -81,8 +81,8 @@ embedded album art:
 * ``beet embedart [-f IMAGE] QUERY``: embed images into the every track on the
   albums matching the query. If the ``-f`` (``--file``) option is given, then
   use a specific image file from the filesystem; otherwise, each album embeds
-  its own currently associated album art. Will prompt for confirmation before 
-  making the change unless the ``-y`` (``--yes``) option is specified.
+  its own currently associated album art. The command prompts for confirmation
+  before making the change unless you specify the ``-y`` (``--yes``) option.
 
 * ``beet extractart [-a] [-n FILE] QUERY``: extracts the images for all albums
   matching the query. The images are placed inside the album folder. You can