diff --git a/README.rst b/README.rst
index fd2fabd..3e2548b 100644
--- a/README.rst
+++ b/README.rst
@@ -2,11 +2,13 @@
 vdirsyncer
 ==========
 
-Vdirsyncer synchronizes your calendars and addressbooks between two storages.
+Vdirsyncer synchronizes your calendars and addressbooks between two storages_.
 The most popular purpose is to synchronize CalDAV and CardDAV with a local
-folder or file. The local data can then be `accessed via a variety of programs
-<https://vdirsyncer.readthedocs.org/en/stable/supported.html>`_, none of which
-have to know or worry about syncing to a server.
+folder or file. The local data can then be programs_, none of which have to
+know or worry about syncing to a server.
+
+.. _storages: https://vdirsyncer.readthedocs.org/en/latest/config.html#storages
+.. _programs: https://vdirsyncer.readthedocs.org/en/stable/supported.html
 
 It aims to be for CalDAV and CardDAV what `OfflineIMAP
 <http://offlineimap.org/>`_ is for IMAP.
diff --git a/docs/index.rst b/docs/index.rst
index 3e912d6..51b8e22 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -2,11 +2,11 @@
 vdirsyncer
 ==========
 
-Vdirsyncer synchronizes your calendars and addressbooks between two storages.
-The most popular purpose is to synchronize CalDAV and CardDAV with a local
-folder or file. The local data can then be :doc:`accessed via a variety of
-programs <supported>`, none of which have to know or worry about syncing to a
-server.
+Vdirsyncer synchronizes your calendars and addressbooks between two
+:ref:`storages <storages>`. The most popular purpose is to synchronize CalDAV
+and CardDAV with a local folder or file. The local data can then be accessed
+via a variety of :doc:`programs <supported>`, none of which have to know or
+worry about syncing to a server.
 
 It aims to be for CalDAV and CardDAV what `OfflineIMAP
 <http://offlineimap.org/>`_ is for IMAP.