Docs fixes for metasync: #1386

Author: sampsyo

docs/changelog.rst

@@ -5,7 +5,8 @@ Changelog
 -----------------------
 
 This little update makes queries more powerful and removes a performance
-bottleneck.
+bottleneck. There's an experimental new plugin for synchronizing metadata with
+music players.
 
 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
@@ -17,6 +18,8 @@ New features:
   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`
+* An experimental new :doc:`/plugins/metasync` lets you get metadata from your
+  favorite music players, starting with Amarok. :bug:`1386`
 * 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`

docs/plugins/metasync.rst

@@ -2,22 +2,25 @@ MetaSync Plugin
 ===============
 
 This plugin provides the ``metasync`` command, which lets you fetch certain
-metadata from other local or remote sources, for example your favorite audio
-player.
+metadata from other sources: for example, your favorite audio player.
 
-Currently we support the following list of metadata sources:
-- **amarok**: This syncs rating, score, first played, last played, playcount and uid from amarok.
+Currently, the plugin supports synchronizing with the `Amarok`_ music player.
+It can fetch the rating, score, first-played date, last-played date, play
+count, and track uid from Amarok.
 
+.. _Amarok: https://amarok.kde.org/
 
-Installing Dependencies
------------------------
 
-Fetching metadata from amarok requires the dbus-python library.
+Installation
+------------
 
-There are packages for most major linux distributions, or you can download the
-library from its _website.
+Enable the ``metasync`` plugin in your configuration (see
+:ref:`using-plugins`).
+
+To synchronize with Amarok, you'll need the `dbus-python`_ library. There are
+packages for most major Linux distributions.
 
-   _website: http://dbus.freedesktop.org/releases/dbus-python/
+.. _dbus-python: http://dbus.freedesktop.org/releases/dbus-python/
 
 
 Configuration
@@ -26,16 +29,16 @@ Configuration
 To configure the plugin, make a ``metasync:`` section in your configuration
 file. The available options are:
 
-- **source**: A list of sources to fetch metadata from.
+- **source**: A list of sources to fetch metadata from. Set this to "amarok"
+  to enable synchronization with that player.
   Default: empty
 
 
 Usage
 -----
 
-Enable the ``metasync`` plugin in your configuration (see
-:ref:`using-plugins`) then run ``beet metasync QUERY`` to fetch updated
-metadata from the configured list of sources.
+Run ``beet metasync QUERY`` to fetch metadata from the configured list of
+sources.
 
 The command has a few command-line options: