diff --git a/docs/reference/troubleshooting/snapshot/add-repository.asciidoc b/docs/reference/troubleshooting/snapshot/add-repository.asciidoc
index 386c2561c03c6..e70bd244df3a5 100644
--- a/docs/reference/troubleshooting/snapshot/add-repository.asciidoc
+++ b/docs/reference/troubleshooting/snapshot/add-repository.asciidoc
@@ -2,8 +2,12 @@
 == Troubleshooting broken repositories
 
 There are several situations where the <<health-api, Health API>> might report an issue
-regarding the integrity of snapshot repositories in the cluster. This page explains
-the recommended actions for diagnosing corrupted, unknown, and invalid repositories.
+regarding the integrity of snapshot repositories in the cluster. The following pages explain
+the recommended actions for diagnosing corrupted, unknown, and invalid repositories:
+
+- <<diagnosing-corrupted-repositories>>
+- <<diagnosing-unknown-repositories>>
+- <<diagnosing-invalid-repositories>>
 
 [[diagnosing-corrupted-repositories]]
 === Diagnosing corrupted repositories