diff --git a/docs/changelog.rst b/docs/changelog.rst
index 5ca5a7c0d..69aa4da8d 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -19,6 +19,12 @@ Fixes:
 * Fix a crash when the importer deals with Unicode metadata in ``--pretend``
   mode. :bug:`1214`
 
+For developers: The logging system in beets has been overhauled. Plugins now
+each have their own logger, which helps by automatically adjusting the
+verbosity level in import mode and by prefixing the plugin's name. Also,
+logging calls can (and should!) use modern ``{}``-style string formatting
+lazily. See :ref:`plugin-logging` in the plugin API docs.
+
 
 1.3.10 (January 5, 2015)
 ------------------------
diff --git a/docs/dev/plugins.rst b/docs/dev/plugins.rst
index 6eea738e7..d81810bde 100644
--- a/docs/dev/plugins.rst
+++ b/docs/dev/plugins.rst
@@ -459,6 +459,8 @@ Specifying types has several advantages:
 * User input for flexible fields may be validated and converted.
 
 
+.. _plugin-logging:
+
 Logging
 ^^^^^^^