Build docs

Author: gmarz

Diff for: docs/build/nest/connecting.html

@@ -16,7 +16,28 @@ <h2 id="changing-the-underlying-connection">Changing the underlying connection</
 <pre><code>var client = new ElasticClient(settings, new ThriftConnection(settings));
 </code></pre><p>NEST comes with an Http Connection <code>HttpConnection</code>, Thrift Connection <code>ThriftConnection</code> 
 and an In-Memory Connection <code>InMemoryConnection</code>, that nevers hits Elasticsearch.</p>
-<h2 id="settings">Settings</h2>
+<p>You can also roll your own connection if desired by implementing the <code>IConnection</code> interface.</p>
+<h2 id="subclassing-existing-connection-implementations">Subclassing existing connection implementations</h2>
+<p>In addition to implementing your own <code>IConnection</code>, the existing <code>HttpConnection</code> and <code>ThriftConnection</code> are extendible and can be subclassed in order to modify or extend their behavior.</p>
+<p>For instance, a common use case is the ability to add client certificates to web requests.  You can subclass <code>HttpConnection</code> and override the <code>CreateHttpWebRequest</code> method that creates the web request, and add certificates to it like so:</p>
+<pre><code>public class SignedHttpConnection : HttpConnection
+{
+    private readonly X509CertificateCollection _certificates;
+
+    public SignedHttpConnection(IConnectionConfigurationValues settings, X509CertificateCollection certificates)
+        : base(settings)
+    {
+        _certificates = certificates;
+    }
+
+    protected override HttpWebRequest CreateHttpWebRequest(Uri uri, string method, byte[] data, IRequestConfiguration requestSpecificConfig)
+    {
+        var request = base.CreateHttpWebRequest(uri, method, data, requestSpecificConfig);
+        request.ClientCertificates = _certificates;
+        return request;
+    }
+}
+</code></pre><h2 id="settings">Settings</h2>
 <p>The <code>NEST</code> client can be configured by passing in an <code>IConnectionSettingsValues</code> object, which is a sub-interface of 
 <code>Elasticsearch.Net</code>&#39;s <code>IConnectionConfigurationValues</code>.  Therefore all of the settings that can be used to 
 <a href="/elasticsearch-net/connection.html">configure Elasticsearch.Net</a> also apply here, including the 

Diff for: docs/build/nest/indices/create-indices.html

@@ -4,13 +4,16 @@
 <h2 id="note">Note</h2>
 <p>When adding settings strip the <code>index.</code> prefix. This applies to settings found in the <a href="http://www.elasticsearch.org/guide/reference/index-modules/">Index Module</a> documentation.</p>
 <h2 id="simple-example">Simple example</h2>
-<pre><code>var client = this.ConnectedClient;
-var settings = new IndexSettings();
+<pre><code>var settings = new IndexSettings();
 settings.NumberOfReplicas = 1;
 settings.NumberOfShards = 5;
-settings.Add(&quot;merge.policy.merge_factor&quot;,&quot;10&quot;);
-settings.Add(&quot;search.slowlog.threshold.fetch.warn&quot;, &quot;1s&quot;);
-client.CreateIndex(&quot;myindexname&quot;, settings);
+settings.Settings.Add(&quot;merge.policy.merge_factor&quot;,&quot;10&quot;);
+settings.Settings.Add(&quot;search.slowlog.threshold.fetch.warn&quot;, &quot;1s&quot;);
+
+client.CreateIndex(c =&gt; c
+    .Index(&quot;myindexname&quot;)
+    .InitializeUsing(settings)
+);
 </code></pre><h2 id="create-index-with-settings-and-mappings-in-one-go-fluently">Create index with settings and mappings in one go fluently</h2>
 <pre><code>client.CreateIndex(&quot;myindexname&quot;, c =&gt; c
     .NumberOfReplicas(0)

Diff for: docs/build/nest/indices/put-mapping.html

@@ -41,39 +41,34 @@ <h2 id="attribute-based-mapping">Attribute based mapping</h2>
 <p><strong>ALSO NOTE</strong>: <code>Map&lt;T&gt;()</code> will also explicitly map string properties as strings with elasticsearch even if they do not have an attribute on them. It does this for all the value types (string, int, float, double, DateTime).</p>
 <h2 id="code-based-mapping">Code based mapping</h2>
 <p>You can also create mappings on the fly:</p>
-<pre><code>var typeMapping = new TypeMapping(Guid.NewGuid().ToString(&quot;n&quot;));
-var property = new TypeMappingProperty
+<pre><code>var indexDefinition = new RootObjectMapping
 {
-    Type = &quot;multi_field&quot;
+    Properties = new Dictionary&lt;PropertyNameMarker, IElasticType&gt;(),
+    Name = indexName
 };
 
-var primaryField = new TypeMappingProperty
+var property = new StringMapping
 {
-    Type = &quot;string&quot;, 
     Index = &quot;not_analyzed&quot;
 };
 
-var analyzedField = new TypeMappingProperty
+var analyzedField = new StringMapping
 {
-    Type = &quot;string&quot;, 
     Index = &quot;analyzed&quot;
 };
 
-property.Fields = new Dictionary&lt;string, TypeMappingProperty&gt;();
-property.Fields.Add(&quot;name&quot;, primaryField);
 property.Fields.Add(&quot;name_analyzed&quot;, analyzedField);
-
-typeMapping.Properties.Add(&quot;name&quot;, property);
-this.ConnectedClient.Map(typeMapping);
+indexDefinition.Properties.Add(&quot;name&quot;, property);
+this.ConnectedClient.Map&lt;object&gt;(x =&gt; x.InitializeUsing(indexDefinition));
 </code></pre><h2 id="multifield-mapping">Multifield Mapping</h2>
 <p>To create multifield type you can use following example. </p>
 <pre><code>var result = this._client.Map&lt;ElasticsearchProject&gt;(m =&gt; m
     .Properties(props =&gt; props
-    .MultiField(s =&gt; s
+    .String(s =&gt; s
     .Name(p =&gt; p.Name)
     .Path(MultiFieldMappingPath.Full)
+    .Index(FieldIndexOption.not_analyzed)
     .Fields(pprops =&gt; pprops
-        .String(ps =&gt; ps.Name(p =&gt; p.Name).Index(FieldIndexOption.not_analyzed))
         .String(ps =&gt; ps.Name(p =&gt; p.Name.Suffix(&quot;searchable&quot;)).Index(FieldIndexOption.analyzed))
     )
     ))