From d35a68d0d8cfa4b1481365f5bee8ae2bc0c96dbf Mon Sep 17 00:00:00 2001
From: Adrian Sampson <adrian@radbox.org>
Date: Sat, 12 Jan 2019 14:20:16 -0800
Subject: [PATCH] Refine writing/links for #3116

---
 docs/reference/config.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/reference/config.rst b/docs/reference/config.rst
index 09af74b3e..57cb6c295 100644
--- a/docs/reference/config.rst
+++ b/docs/reference/config.rst
@@ -654,7 +654,7 @@ Default: ``{}`` (empty).
 MusicBrainz Options
 -------------------
 
-You can instruct beets to use `your own`_ MusicBrainz database instead of
+You can instruct beets to use `your own MusicBrainz database`_ instead of
 the `main server`_. Use the ``host`` and ``ratelimit`` options under a
 ``musicbrainz:`` header, like so::
 
@@ -664,17 +664,17 @@ the `main server`_. Use the ``host`` and ``ratelimit`` options under a
 
 The ``host`` key, of course, controls the Web server hostname (and port,
 optionally) that will be contacted by beets (default: musicbrainz.org).
-The ``host`` must have search indexes enabled -- see "Building search indexes"
-in the server setup guide linked above.
+The server must have search indices enabled (see `Building search indexes`_).
 
 The ``ratelimit`` option, an integer, controls the number of Web service requests
 per second (default: 1). **Do not change the rate limit setting** if you're
 using the main MusicBrainz server---on this public server, you're `limited`_
 to one request per second.
 
-.. _your own: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
+.. _your own MusicBrainz database: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
 .. _main server: https://musicbrainz.org/
 .. _limited: http://musicbrainz.org/doc/XML_Web_Service/Rate_Limiting
+.. _Building search indexes: https://musicbrainz.org/doc/MusicBrainz_Server/Setup#Building_search_indexes
 
 .. _searchlimit: