diff --git a/docs/changelog.rst b/docs/changelog.rst
index 6cdf5365..931e1437 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -169,9 +169,9 @@ Audio
   This should be fixed properly together with :issue:`1222`. (Fixes:
   :issue:`1430`, PR: :issue:`1438`)
 
-- Add a new config option, buffer_time, for setting the buffer time of the
-  GStreamer queue. If you experience buffering before track changes, it may
-  help to increase this. Workaround for :issue:`1409`.
+- Add a new config option, :confval:`audio/buffer_time`, for setting the buffer
+  time of the GStreamer queue. If you experience buffering before track
+  changes, it may help to increase this. Workaround for :issue:`1409`.
 
 Gapless
 -------
diff --git a/docs/config.rst b/docs/config.rst
index bf131dbe..b0d2e52e 100644
--- a/docs/config.rst
+++ b/docs/config.rst
@@ -162,8 +162,9 @@ These are the available audio configurations. For specific use cases, see
     Expects an integer above 0.
 
     Sets the buffer size of the GStreamer queue. If you experience buffering
-    before track changes, it may help to increase this. The default is letting
-    GStreamer decide the size.
+    before track changes, it may help to increase this, possibly by at least a
+    few seconds. The default is letting GStreamer decide the size, which at the
+    time of this writing is 1000.
 
 
 Logging configuration