diff --git a/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsBuildTimeConfig.java b/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsBuildTimeConfig.java
index 0c3070015b00d..0d7c3c1f58707 100644
--- a/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsBuildTimeConfig.java
+++ b/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsBuildTimeConfig.java
@@ -38,11 +38,11 @@ interface RestClientBuildConfig {
         Optional<String> scope();
 
         /**
-         * If set to true, then Quarkus will ensure that all calls from the rest client go through a local proxy
+         * If set to true, then Quarkus will ensure that all calls from the REST client go through a local proxy
          * server (that is managed by Quarkus).
-         * This can be very useful for capturing network traffic to a service that use HTTPS.
+         * This can be very useful for capturing network traffic to a service that uses HTTPS.
          * <p>
-         * This property is not applicable to the RESTEasy Client, only the Quarkus Rest client (formerly RESTEasy Reactive
+         * This property is not applicable to the RESTEasy Client, only the Quarkus REST client (formerly RESTEasy Reactive
          * client).
          * <p>
          * This property only applicable to dev and test mode.
@@ -56,7 +56,7 @@ interface RestClientBuildConfig {
          * <p>
          * The algorithm for picking between multiple provider is the following:
          * <ul>
-         * <li>If only the default is around, use it (it's name is {@code default})</li>
+         * <li>If only the default is around, use it (its name is {@code default})</li>
          * <li>If there is only one besides the default, use it</li>
          * <li>If there are multiple ones, fail</li>
          * </ul>
diff --git a/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsConfig.java b/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsConfig.java
index 81494a2ebe334..32695f92e8fba 100644
--- a/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsConfig.java
+++ b/extensions/resteasy-classic/rest-client-config/runtime/src/main/java/io/quarkus/restclient/config/RestClientsConfig.java
@@ -28,6 +28,7 @@ public interface RestClientsConfig {
      */
     @WithParentName
     @WithDefaults
+    @ConfigDocMapKey("client")
     Map<String, RestClientConfig> clients();
 
     /**