Regenerate docs

Author: russcam

docs/aggregations.asciidoc

@@ -4,7 +4,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/aggregations.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/aggregations.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////

docs/breaking-changes.asciidoc

@@ -3,7 +3,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/breaking-changes.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/breaking-changes.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////

docs/client-concepts/certificates/working-with-certificates.asciidoc

@@ -15,19 +15,19 @@ please modify the original csharp file found at the link and submit the PR with
 [[working-with-certificates]]
 === Working with certificates
 
-If you've enabled SSL on Elasticsearch with https://www.elastic.co/products/x-pack[X-Pack] or through a
+If you've enabled SSL on Elasticsearch with https://www.elastic.co/products/elastic-stack[Elastic Stack Security features], or through a
 proxy in front of Elasticsearch, and the Certificate Authority (CA)
-that generated the certificate is trusted by the machine running the client code, there should be nothing you'll have to do to talk
+that generated the certificate is trusted by the machine running the client code, there should be nothing for you to do to talk
 to the cluster over HTTPS with the client.
 
-If you are using your own CA which is not trusted however, .NET won't allow you to make HTTPS calls to that endpoint by default. With .NET,
-you can pre-empt this though a custom validation callback on the global static
+If you are using your own CA which is not trusted however, .NET won't allow you to make HTTPS calls to that endpoint by default.
+With .NET Framework, you can pre-empt this though a custom validation callback on the global static
 `ServicePointManager.ServerCertificateValidationCallback`. Most examples you will find doing this this will simply return `true` from the
 validation callback and merrily whistle off into the sunset. **This is not advisable** as it allows *any* HTTPS traffic through in the
 current `AppDomain` *without* any validation. Here's a concrete example:
 
-Imagine you deploy a web application that talks to Elasticsearch over HTTPS through NEST, and also uses some third party SOAP/WSDL endpoint;
-by setting
+Imagine you deploy a web application that talks to Elasticsearch over HTTPS using NEST, and also uses some third party SOAP/WSDL endpoint.
+By setting the following
 
 [source,csharp]
 ----
@@ -60,30 +60,9 @@ public class DenyAllCertificatesCluster : SslAndKpiXPackCluster
         .ServerCertificateValidationCallback(CertificateValidations.DenyAll); <1>
 }
 ----
-<1> synonymous with the previous lambda expression
+<1> use a lambda expression or `CertificateValidations.DenyAll` to deny all validation
 
-Or per request on `RequestConfiguration` which will take precedence over the ones defined on `ConnectionConfiguration`
-
-==== Object Initializer syntax example 
-
-[source,csharp]
-----
-new RootNodeInfoRequest
-{
-    RequestConfiguration = new RequestConfiguration
-    {
-        ClientCertificates = new X509Certificate2Collection { new X509Certificate2(this.Certificate) }
-    }
-}
-----
-
-==== Fluent DSL example 
-
-[source,csharp]
-----
-s => s
-.RequestConfiguration(r => r
-        .ClientCertificate(this.Certificate)
-)
-----
+If you go for a vendor generated SSL certificate, it's common practice for the certificate to include the CA _and_ any intermediary CAs
+in the certificate chain. When using such a certificate, use `CertificateValidations.AuthorityPartOfChain` which validates that
+the local CA certificate is part of the chain that was used to generate the servers key.
 

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

@@ -32,7 +32,7 @@ Basic Authentication credentials to send with all requests to Elasticsearch
 
 `ClientCertificate`::
 
-Use a `X509Certificate` 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`::
 
@@ -120,7 +120,7 @@ When not specified, defaults to `RequestTimeout` , which itself defaults to `60`
 
 `NodePredicate`::
 
-Register a predicate to select which nodes that you want to execute API calls on. Note that sniffing requests omit this predicate and always execute on all nodes. When using an `IConnectionPool` implementation that supports reseeding of nodes, this will default to omitting master only             node from regular API calls.             When using static or single node connection pooling it is assumed the list of node you instantiate the client with should be taken             verbatim.
+Register a predicate to select which nodes that you want to execute API calls on. Note that sniffing requests omit this predicate and always execute on all nodes. When using an `IConnectionPool` implementation that supports reseeding of nodes, this will default to             omitting master only             node from regular API calls.             When using static or single node connection pooling it is assumed the list of node you instantiate the client with             should be taken             verbatim.
 
 `OnRequestCompleted`::
 
@@ -158,7 +158,7 @@ Configure the client to skip deserialization of certain status codes e.g: you ru
 
 `SniffLifeSpan`::
 
-Set the duration after which a cluster state is considered stale and a sniff should be performed again. An `IConnectionPool` has to signal it supports reseeding, otherwise sniffing will never happen.             Defaults to 1 hour.             Set to null to disable completely. Sniffing will only ever happen on ConnectionPools that return true for SupportsReseeding
+Set the duration after which a cluster state is considered stale and a sniff should be performed again. An `IConnectionPool` has to signal it supports reseeding, otherwise sniffing will never happen.             Defaults to 1 hour.             Set to null to disable completely. Sniffing will only ever happen on ConnectionPools that return true for             SupportsReseeding
 
 `SniffOnConnectionFault`::
 

docs/client-concepts/connection/modifying-default-connection.asciidoc

@@ -114,66 +114,26 @@ to the request, change the maximum number of connections allowed to an endpoint,
 By deriving from `HttpConnection`, it is possible to change the behaviour of the connection. The following
 provides some examples
 
-[[servicepoint-behaviour]]
-===== ServicePoint behaviour
+[[kerberos-authentication]]
+===== Kerberos Authentication
 
-If you are running on the Desktop CLR you can override specific properties for the current `ServicePoint` easily
-by overriding `AlterServicePoint` on an `IConnection` implementation deriving from `HttpConnection`
+For a lot of use cases, deriving from `HttpConnection` is a great way to customize the connection for your needs.
+If you want to authenticate with Kerberos for example, creating a custom `HttpConnection` as follows
+allows you to set the right HTTP headers
 
-[source,csharp]
-----
-public class MyCustomHttpConnection : HttpConnection
-{
-    protected override void AlterServicePoint(ServicePoint requestServicePoint, RequestData requestData)
-    {
-        base.AlterServicePoint(requestServicePoint, requestData);
-        requestServicePoint.ConnectionLimit = 10000;
-        requestServicePoint.UseNagleAlgorithm = true;
-    }
-}
-
-var connection = new MyCustomHttpConnection();
-var connectionPool = new SingleNodeConnectionPool(new Uri("http://localhost:9200"));
-var settings = new ConnectionSettings(connectionPool, connection);
-var client = new ElasticClient(settings);
-----
-
-The Connection limit has been increased from the default 80 to much higher and
-https://en.wikipedia.org/wiki/Nagle's_algorithm[nagling] has been enabled, which is disabled by default in the client.
-
-NOTE: The client reuses TCP connections through .NET's internal connection pooling,
-so changing the connection limit to something really high should only be done with careful
-consideration and testing. It's demonstrated here only as an example.
-
-[[x509-certificates]]
-===== X.509 Certificates
-
-It is possible to add X509 certificates to each request from the client by overriding the `CreateHttpWebRequest`
-method in an `IConnection` implementation deriving from `HttpConnection`
+TIP: use something like https://www.nuget.org/packages/Kerberos.NET/ to fill in the actual blanks of this implementation
 
 [source,csharp]
 ----
-public class X509CertificateHttpConnection : HttpConnection
+public class KerberosConnection : HttpConnection
 {
-    protected override HttpWebRequest CreateHttpWebRequest(RequestData requestData)
+    protected override HttpRequestMessage CreateRequestMessage(RequestData requestData)
     {
-        var request = base.CreateHttpWebRequest(requestData);
-        request.ClientCertificates.Add(new X509Certificate("file_path_to_cert"));
-        return request;
+        var message = base.CreateRequestMessage(requestData);
+        var header = string.Empty;
+        message.Headers.Authorization = new AuthenticationHeaderValue("Negotiate", header);
+        return message;
     }
 }
 ----
 
-As before, a new instance of the custom connection is passed to `ConnectionSettings` in order to
-use
-
-[source,csharp]
-----
-var connection = new X509CertificateHttpConnection();
-var connectionPool = new SingleNodeConnectionPool(new Uri("http://localhost:9200"));
-var settings = new ConnectionSettings(connectionPool, connection);
-var client = new ElasticClient(settings);
-----
-
-See <<working-with-certificates, Working with certificates>> for further details.
-

docs/code-standards/naming-conventions.asciidoc

@@ -174,6 +174,8 @@ var elasticsearchNetAssembly = typeof(IElasticLowLevelClient).Assembly;
 
 var exceptions = new List<Type>
 {
+    elasticsearchNetAssembly.GetType("Microsoft.CodeAnalysis.EmbeddedAttribute"),
+    elasticsearchNetAssembly.GetType("System.Runtime.CompilerServices.IsReadOnlyAttribute"),
     elasticsearchNetAssembly.GetType("System.AssemblyVersionInformation"),
     elasticsearchNetAssembly.GetType("System.FormattableString"),
     elasticsearchNetAssembly.GetType("System.Runtime.CompilerServices.FormattableStringFactory"),

docs/conventions.asciidoc

@@ -20,7 +20,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/conventions.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/conventions.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////

docs/high-level.asciidoc

@@ -6,7 +6,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/high-level.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/high-level.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////

docs/index.asciidoc

@@ -6,7 +6,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/index.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/index.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////

docs/intro.asciidoc

@@ -5,7 +5,7 @@
 ////
 IMPORTANT NOTE
 ==============
-This file has been generated from https://github.com/elastic/elasticsearch-net/tree/master/src/Tests/Tests/intro.asciidoc. 
+This file has been generated from https://github.com/elastic/elasticsearch-net/tree/6.x/src/Tests/Tests/intro.asciidoc. 
 If you wish to submit a PR for any spelling mistakes, typos or grammatical errors for this file,
 please modify the original csharp file found at the link and submit the PR with that change. Thanks!
 ////