Rework of #3713 - thanks @adonaiohesed

Author: codebrain

docs/client-concepts/connection/configuration-options.asciidoc

@@ -32,11 +32,11 @@ Basic Authentication credentials to send with all requests to Elasticsearch
 
 `ClientCertificate`::
 
-Use the following certificate to authenticate all HTTP requests. You can also set them on individual request using `ClientCertificates`
+Use a `X509Certificate` to authenticate all HTTP requests. You can also set them on individual request using `ClientCertificates`
 
 `ClientCertificate`::
 
-Use the following certificate to authenticate all HTTP requests. You can also set them on individual request using `ClientCertificates`
+Use a file path to a certificate to authenticate all HTTP requests. You can also set them on individual request using `ClientCertificates`
 
 `ClientCertificates`::
 

src/Elasticsearch.Net/Configuration/ConnectionConfiguration.cs

@@ -482,15 +482,13 @@ public T ClientCertificates(X509CertificateCollection certificates) =>
 			Assign(certificates, (a, v) => a._clientCertificates = v);
 
 		/// <summary>
-		/// Use the following certificate to authenticate all HTTP requests. You can also set them on individual
-		/// request using <see cref="RequestConfiguration.ClientCertificates" />
+		/// Use a <see cref="System.Security.Cryptography.X509Certificates.X509Certificate"/> to authenticate all HTTP requests. You can also set them on individual request using <see cref="RequestConfiguration.ClientCertificates" />
 		/// </summary>
 		public T ClientCertificate(X509Certificate certificate) =>
 			Assign(new X509Certificate2Collection { certificate }, (a, v) => a._clientCertificates = v);
 
 		/// <summary>
-		/// Use the following certificate to authenticate all HTTP requests. You can also set them on individual
-		/// request using <see cref="RequestConfiguration.ClientCertificates" />
+		/// Use a file path to a certificate to authenticate all HTTP requests. You can also set them on individual request using <see cref="RequestConfiguration.ClientCertificates" />
 		/// </summary>
 		public T ClientCertificate(string certificatePath) =>
 			Assign(new X509Certificate2Collection { new X509Certificate(certificatePath) }, (a, v) => a._clientCertificates = v);