diff --git a/docs/src/main/asciidoc/redis-reference.adoc b/docs/src/main/asciidoc/redis-reference.adoc
index 2a07b990f48b2..9972228a87707 100644
--- a/docs/src/main/asciidoc/redis-reference.adoc
+++ b/docs/src/main/asciidoc/redis-reference.adoc
@@ -714,7 +714,7 @@ public static class MyExampleCustomizer implements RedisOptionsCustomizer {
 
 === Dev Services
 
-See link:redis-dev-services.adoc[Redis Dev Service].
+See xref:redis-dev-services.adoc[Redis Dev Service].
 
 [[redis-configuration-reference]]
 == Configuration Reference
diff --git a/docs/src/main/asciidoc/redis.adoc b/docs/src/main/asciidoc/redis.adoc
index cedbf72431104..57a2e59c3372f 100644
--- a/docs/src/main/asciidoc/redis.adoc
+++ b/docs/src/main/asciidoc/redis.adoc
@@ -526,4 +526,4 @@ Once the build is finished, you can run the executable with:
 
 == Going further
 
-To learn more about the Quarkus Redis extension, check link:redis-reference.adoc[the Redis extension reference guide].
+To learn more about the Quarkus Redis extension, check xref:redis-reference.adoc[the Redis extension reference guide].