diff --git a/doc/cabal-package-description-file.rst b/doc/cabal-package-description-file.rst
index f04e4c7fb1a..dc452570980 100644
--- a/doc/cabal-package-description-file.rst
+++ b/doc/cabal-package-description-file.rst
@@ -2719,10 +2719,7 @@ its ``--source-repository`` option, if provided.
 
 .. _source-repository-fields:
 
-Marker VCS Fields
-^^^^^^^^^^^^^^^^^
-
-The fields of ``source-repository``.
+The :ref:`VCS fields<vcs-fields>` of ``source-repository`` are:
 
 ..
   data SourceRepo = SourceRepo
diff --git a/doc/cabal-project-description-file.rst b/doc/cabal-project-description-file.rst
index aecff7e1342..7f6fb8749a6 100644
--- a/doc/cabal-project-description-file.rst
+++ b/doc/cabal-project-description-file.rst
@@ -245,10 +245,7 @@ their use just like Hackage or locally defined packages.
 
 .. _source-repository-package-fields:
 
-Source Repository Package Fields
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The fields of ``source-repository-package``.
+The :ref:`VCS fields<vcs-fields>` of ``source-repository-package`` are:
 
 ..
   data SourceRepositoryPackage f = SourceRepositoryPackage