#291: changelog and docs

docs/changelog.rst

@@ -36,6 +36,10 @@ Changelog
   album fields. For consistency, the ``pathfields`` configuration section has
   been renamed ``item_fields`` (although the old name will still work for
   compatibility).
+* Plugins can also provide metadata matches for ID searches. For example, the
+  new Discogs plugin lets you search for an album by its Discogs ID from the
+  same prompt that previously just accepted MusicBrainz IDs. Thanks to
+  Johannes Baiter.
 * The :ref:`fields-cmd` command shows template fields provided by plugins.
   Thanks again to Pedro Silva.
 * Album art filenames now respect the :ref:`replace` configuration.

docs/plugins/discogs.rst

@@ -17,4 +17,7 @@ install the `discogs-client`_ library by typing::
 That's it! Matches from Discogs will now show up during import alongside
 matches from MusicBrainz.
 
+If you have a Discogs ID for an album you want to tag, you can also enter it
+at the "enter Id" prompt in the importer.
+
 .. _discogs-client: https://github.com/discogs/discogs_client

docs/plugins/writing.rst

@@ -189,9 +189,15 @@ methods on the plugin class:
   return a list of ``TrackInfo`` objects for candidate tracks to be compared and
   matched.
 
-When implementing these functions, it will probably be very necessary to use the
-functions from the ``beets.autotag`` and ``beets.autotag.mb`` modules, both of
-which have somewhat helpful docstrings.
+* ``album_for_id(self, album_id)``: given an ID from user input or an album's
+  tags, return a candidate AlbumInfo object (or None).
+
+* ``track_for_id(self, track_id)``: given an ID from user input or a file's
+  tags, return a candidate TrackInfo object (or None).
+
+When implementing these functions, you may want to use the functions from the
+``beets.autotag`` and ``beets.autotag.mb`` modules, both of which have
+somewhat helpful docstrings.
 
 Read Configuration Options
 ^^^^^^^^^^^^^^^^^^^^^^^^^^