Finalizing Azure Key JavaDocs (#9696)

* Fixed grammatical mistake in JavaDoc

* Additional documentation updates

sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java

@@ -8,7 +8,7 @@
 import java.util.Objects;
 
 /**
- * Represents a credential that uses a key authenticate to an Azure Service.
+ * Represents a credential that uses a key to authenticate to an Azure Service.
  */
 public final class AzureKeyCredential {
     private final ClientLogger logger = new ClientLogger(AzureKeyCredential.class);

sdk/core/azure-core/src/main/java/com/azure/core/http/policy/AzureKeyCredentialPolicy.java

@@ -14,7 +14,6 @@
 
 /**
  * Pipeline policy that uses an {@link AzureKeyCredential} to set the authorization key for a request.
- *
  * <p>
  * Requests sent with this pipeline policy are required to use {@code HTTPS}. If the request isn't using {@code HTTPS}
  * an exception will be thrown to prevent leaking the key.
@@ -26,9 +25,9 @@ public final class AzureKeyCredentialPolicy implements HttpPipelinePolicy {
     private final AzureKeyCredential credential;
 
     /**
-     * Creates a policy that uses the passed {@link AzureKeyCredential} to set the specified name.
+     * Creates a policy that uses the passed {@link AzureKeyCredential} to set the specified header name.
      *
-     * @param name The name of the key header that will be set to the {@link AzureKeyCredential} key value.
+     * @param name The name of the key header that will be set to {@link AzureKeyCredential#getKey()}.
      * @param credential The {@link AzureKeyCredential} containing the authorization key to use.
      * @throws NullPointerException If {@code name} or {@code credential} is {@code null}.
      * @throws IllegalArgumentException If {@code name} is empty.