diff --git a/client/integration-tests/auth-provider/src/main/java/io/quarkiverse/openapi/generator/it/auth/provider/CustomCredentialsProvider.java b/client/integration-tests/auth-provider/src/main/java/io/quarkiverse/openapi/generator/it/auth/provider/CustomCredentialsProvider.java
index b9022e80..6cc0ac01 100644
--- a/client/integration-tests/auth-provider/src/main/java/io/quarkiverse/openapi/generator/it/auth/provider/CustomCredentialsProvider.java
+++ b/client/integration-tests/auth-provider/src/main/java/io/quarkiverse/openapi/generator/it/auth/provider/CustomCredentialsProvider.java
@@ -5,14 +5,12 @@
 import jakarta.annotation.Priority;
 import jakarta.enterprise.context.Dependent;
 import jakarta.enterprise.inject.Alternative;
-import jakarta.enterprise.inject.Specializes;
 
 import io.quarkiverse.openapi.generator.providers.ConfigCredentialsProvider;
 import io.quarkiverse.openapi.generator.providers.CredentialsContext;
 
 @Dependent
 @Alternative
-@Specializes
 @Priority(201)
 public class CustomCredentialsProvider extends ConfigCredentialsProvider {
     public CustomCredentialsProvider() {
diff --git a/docs/modules/ROOT/pages/includes/custom-auth-provider.adoc b/docs/modules/ROOT/pages/includes/custom-auth-provider.adoc
index b5984c93..edb03b42 100644
--- a/docs/modules/ROOT/pages/includes/custom-auth-provider.adoc
+++ b/docs/modules/ROOT/pages/includes/custom-auth-provider.adoc
@@ -27,7 +27,7 @@ import io.quarkiverse.openapi.generator.providers.CredentialsProvider;
 
 @RequestScoped
 @Alternative
-@Priority(200) // A higher priority than the default provider.
+@Priority(200) // <1>
 public class RuntimeCredentialsProvider implements CredentialsProvider {
 
     @Override
@@ -58,6 +58,8 @@ public class RuntimeCredentialsProvider implements CredentialsProvider {
 }
 ----
 
+<1> Note the `@Priority(200)` annotation. This ensures that your custom provider takes precedence over the default implementation.
+
 == How It Works
 
 * `openApiSpecId` – Identifies the specific OpenAPI specification file.