diff --git a/docs/changelog.rst b/docs/changelog.rst
index 375f9b5db..f3db33e93 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -4,24 +4,31 @@ Changelog
 1.3.12 (in development)
 -----------------------
 
+This little update makes queries more powerful and removes a performance
+bottleneck.
+
+Packagers should also note a new dependency in this version: the `Jellyfish`_
+Python library makes our text comparisons (a big part of the auto-tagging
+process) go much faster.
+
 New features:
 
-* The autotagger's matching algorithm should be a bit faster. We now
-  use the `Jellyfish`_ library to compute string similarity, which is better
-  optimized than our hand-rolled edit distance implementation. :bug:`1389`
-* :doc:`/plugins/fetchart`: There are new settings to control what constitutes
-  "acceptable" images. The `minwidth` option constrains the minimum image
-  width in pixels and the `enforce_ratio` option requires that images be
-  square. :bug:`1394`
 * Queries can now use **"or" logic**: if you use a comma to separate parts of a
   query, items and albums will match *either* side of the comma. For example,
   ``beet ls foo , bar`` will get all the items matching `foo` or matching
   `bar`. See :ref:`combiningqueries`. :bug:`1423`
+* The autotagger's **matching algorithm is faster**. We now use the
+  `Jellyfish`_ library to compute string similarity, which is better optimized
+  than our hand-rolled edit distance implementation. :bug:`1389`
+* :doc:`/plugins/fetchart`: There are new settings to control what constitutes
+  **"acceptable" images**. The `minwidth` option constrains the minimum image
+  width in pixels and the `enforce_ratio` option requires that images be
+  square. :bug:`1394`
 
 Little fixes and improvements:
 
-* :doc:`/plugins/fetchart`: Remove hard size limit when fetching from the
-  CoverArtArchive.
+* :doc:`/plugins/fetchart`: Remove a hard size limit when fetching from the
+  Cover Art Archive.
 * The output of the :ref:`fields-cmd` command is now sorted. Thanks to
   :user:`multikatt`. :bug:`1402`
 * :doc:`/plugins/replaygain`: Fix a number of issues with the new
diff --git a/docs/plugins/discogs.rst b/docs/plugins/discogs.rst
index c5d9f80f5..038718f9b 100644
--- a/docs/plugins/discogs.rst
+++ b/docs/plugins/discogs.rst
@@ -32,9 +32,11 @@ Several issues have been encountered with the Discogs API. If you have one,
 please start by searching for `a similar issue on the repo
 <https://github.com/sampsyo/beets/issues?utf8=%E2%9C%93&q=is%3Aissue+discogs>`_.
 
-Two tips can generally be given:
+Here are two things you can try:
 
-* Delete the token file (``discogs_token.json`` by default).
-* Make sure that your system clock is on time.
+* Try deleting the token file (``~/.config/beets/discogs_token.json`` by
+  default) to force re-authorization.
+* Make sure that your system clock is accurate. The Discogs servers can reject
+  your request if your clock is too out of sync.
 
 .. _discogs-client: https://github.com/discogs/discogs_client