diff --git a/docs/integrations/github/discovery.md b/docs/integrations/github/discovery.md
index db4952f904..2096202cd8 100644
--- a/docs/integrations/github/discovery.md
+++ b/docs/integrations/github/discovery.md
@@ -54,12 +54,12 @@ const builder = await CatalogBuilder.create(env);
 builder.setRefreshIntervalSeconds(300);
 ```
 
-Alternatively, or additionally, you can use the [github-apps plugin] which
-carries a much higher rate limit at GitHub.
+Alternatively, or additionally, you can configure [github-apps] authentication
+which carries a much higher rate limit at GitHub.
 
 This is true for any method of adding GitHub entities to the catalog, but
 especially easy to hit with automatic discovery.
 
 [rate limits]:
   https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting
-[github-apps plugin]: ../../plugins/github-apps.md
+[github-apps]: ../../plugins/github-apps.md
diff --git a/docs/integrations/github/locations.md b/docs/integrations/github/locations.md
index 5b972f332c..330b03eab9 100644
--- a/docs/integrations/github/locations.md
+++ b/docs/integrations/github/locations.md
@@ -60,5 +60,7 @@ preferred.
 ## Authentication with GitHub Apps
 
 Alternatively, Backstage can use GitHub Apps for backend authentication. This
-has higher rate limits, and a clearer authorization model. See the
-[github-apps plugin](../../plugins/github-apps.md) for how to set this up.
+has higher rate limits, and a clearer authorization model. See [github-apps] for
+how to set this up.
+
+[github-apps]: ../../plugins/github-apps.md