diff --git a/doc/markup/inline.rst b/doc/markup/inline.rst
index 2349bf7ea..164cf37c0 100644
--- a/doc/markup/inline.rst
+++ b/doc/markup/inline.rst
@@ -166,6 +166,8 @@ The following role creates a cross-reference to the term in the glossary:
    during build.
 
 
+.. _ref-role:
+
 Cross-referencing arbitrary locations
 -------------------------------------
 
diff --git a/doc/rest.rst b/doc/rest.rst
index 988e46e59..4984f642d 100644
--- a/doc/rest.rst
+++ b/doc/rest.rst
@@ -141,7 +141,7 @@ Internal links
 ^^^^^^^^^^^^^^
 
 Internal linking is done via a special reST role, see the section on specific
-markup, :ref:`doc-ref-role`.
+markup, :ref:`ref-role`.
 
 
 Sections