finished documentating all the section under search

Author: Mpdreamz

new_docs/contents/search/basics.markdown

@@ -6,6 +6,64 @@ menuitem: basics
 ---
 
 
-# Documentation still in progress
+# From/Size
+
+	s.From(120).Size(20);
+
+this is also valid
+
+	.Skip(120).Take(20)
+
+# Indices / Types
+You can explicitly tell NEST to use multiple indices:
+
+	client.Search<MyObject>(s=>s
+	    .Indices(new [] {"Index_A", "Index_B"})
+	    ...
+	)
+
+If you want to search across all indices
+
+	client.Search<MyObject>(s=>s
+	    .AllIndices()
+	    ...
+	)
+
+Or if you want to search one index (thats not the default index)
+
+	client.Search<MyObject>(s=>s.
+	    .Index("Index_A")
+	    ...
+	)
+
+Remember since elasticsearch 19.8 you can also specify wildcards on index names
+
+	client.Search<MyObject>(s=>s
+	    .Index("Index_*")
+	    ...
+	)
+	.Types(new [] { typeof(ElasticSearchProject)})
+
+## Covariance
+You can make C# covariance work for you by typing the search to a common baseclass (can be object)
+
+i.e:
+
+	.Search<object>(s=>s
+    	.Types(typeof(Product),typeof(Category),typeof(Manufacturer))
+    	.Query(...)
+	);
+
+This will search on `/yourdefaultindex/products,categories,manufacturers/_search` and setup a default `ConcreteTypeSelector` that understands what type each returned document is.
+
+Using 
+
+	.ConcreteTypeSelector(Func<dynamic, Hit<dynamic>, Type>)
+
+you can manually specify the type of each hit based on some json value (on dynamic) or on the hit metadata.
+
+#Routing
+You can specify the routing for the search request using 
+
+	.Routing("routevalue")
 
-This is sadly still a marker file.

new_docs/contents/search/explain.markdown

@@ -6,7 +6,13 @@ menuitem: explain
 ---
 
 
-# Documentation still in progress
+# Explain
 
-This is sadly still a marker file.
+Using explain you'll get more an explanation of each hits score
+
+You can enable it by calling
+
+	.Explain()
+
+On your search request.
 

new_docs/contents/search/fields.markdown

@@ -6,7 +6,15 @@ menuitem: fields
 ---
 
 
-# Documentation still in progress
+# Fields
 
-This is sadly still a marker file.
+Quite often you don't need to waste bandwidth by returning the complete object graph foreach hit. 
+
+Using 
+
+	.Fields(p=>p.Id, p=>p.Name, p=>p.Followers.First().Name, ...)
+
+You can limit the returned fields for each hit.
+
+An overload taking plain strings also exists
 

new_docs/contents/search/highlighting.markdown

@@ -6,7 +6,29 @@ menuitem: highlighting
 ---
 
 
-# Documentation still in progress
+# Highlighting
 
-This is sadly still a marker file.
+Using highlighting you can return the relavent parts of a field and using highlighted markers indicating why a document matched.
 
+	var result = this._client.Search<ElasticSearchProject>(s => s
+		.From(0)
+		.Size(10)
+		.Query(q => q
+			.QueryString(qs => qs
+				.OnField(e => e.Content)
+				.Query("null or null*")
+			)
+		)
+		.Highlight(h => h
+			.PreTags("<b>")
+			.PostTags("</b>")
+			.OnFields(f => f
+				.OnField(e => e.Content)
+				.PreTags("<em>")
+				.PostTags("</em>")
+			)
+		)
+	);
+
+Please take note that this wont alter the contents of the results `.Documents` but the results will have a separate bucket 
+that contains each highlight result(s) for each hit on `result.Highlights`. 

new_docs/contents/search/index-boost.markdown

@@ -6,7 +6,16 @@ menuitem: index-boost
 ---
 
 
-# Documentation still in progress
+# Index boost
 
-This is sadly still a marker file.
+An index boost allows you to boost hits if they originate from a certain index
+
+	var s = new SearchDescriptor<ElasticSearchProject>()
+		.Skip(0)
+		.Take(10)
+		.Explain()
+		.Version()
+		.MinScore(0.4)
+		.IndicesBoost(b => b.Add("index1", 1.4).Add("index2", 1.3));
+	
 

new_docs/contents/search/named-filters.markdown

@@ -6,7 +6,15 @@ menuitem: named-filters
 ---
 
 
-# Documentation still in progress
+# Named Filters
 
-This is sadly still a marker file.
+Each filter allows you specify a name i.e 
+
+	.Filter(f=>f.Name("myfilter").Term(...))
+
+This will allow you to see on each with which filter applied to it.
+
+Right now I'm waiting on this active elasticsearch issue to complete mapping this functionality
+
+https://github.com/elasticsearch/elasticsearch/issues/3097
 

new_docs/contents/search/preference.markdown

@@ -6,7 +6,20 @@ menuitem: preference
 ---
 
 
-# Documentation still in progress
+# Preference
 
-This is sadly still a marker file.
+Signals on what node to execute the search
+
+You can call the following methods on `SearchDescriptor`
+
+	.Preference("my_custom_preference")
+
+
+	.ExecuteOnPrimary()
+
+
+	.ExecuteOnLocalShard
+
+
+	.ExecuteOnNode("mynodename")
 

new_docs/contents/search/script-fields.markdown

@@ -6,7 +6,22 @@ menuitem: script-fields
 ---
 
 
-# Documentation still in progress
-
-This is sadly still a marker file.
+# Script fields
 
+	var queryResults = this._client.Search<ElasticSearchProject>(s=>s
+		.From(0)
+		.Size(10)
+		.MatchAll()
+		.Fields(f=>f.Name)
+		.ScriptFields(sf=>sf
+			.Add("locscriptfield", sff=>sff
+				.Script("doc['loc'].value * multiplier")
+				.Params(sp=>sp
+					.Add("multiplier", 4)
+				)
+			)
+		)
+	);
+	Assert.True(queryResults.IsValid);
+	Assert.True(queryResults.Documents.Any());
+	Assert.True(queryResults.Documents.All(d=>d.LocScriptField != 0));

new_docs/contents/search/scroll.markdown

@@ -5,8 +5,30 @@ menusection: search
 menuitem: scroll
 ---
 
+# Scroll
 
-# Documentation still in progress
+The scroll api allows you to efficiently page through a large dataset as it keeps the query alive in the cluster. 
 
-This is sadly still a marker file.
+	var scanResults = this._client.Search<ElasticSearchProject>(s => s
+		.From(0)
+		.Size(1)
+		.MatchAll()
+		.Fields(f => f.Name)
+		.SearchType(Nest.SearchType.Scan)
+		.Scroll("2s")
+	);
+	Assert.True(scanResults.IsValid);
+	Assert.False(scanResults.Documents.Any());
+	Assert.IsNotNullOrEmpty(scanResults.ScrollId);
 
+	var scrolls = 0;
+	var results = this._client.Scroll<ElasticSearchProject>("4s", scanResults.ScrollId);
+	while (results.Documents.Any())
+	{
+		Assert.True(results.IsValid);
+		Assert.True(results.Documents.Any());
+		Assert.IsNotNullOrEmpty(results.ScrollId);
+		results = this._client.Scroll<ElasticSearchProject>("4s", results.ScrollId);
+		scrolls++;
+	}
+	Assert.AreEqual(18, scrolls);

new_docs/contents/search/search-type.markdown

@@ -6,7 +6,9 @@ menuitem: search-type
 ---
 
 
-# Documentation still in progress
+# Search Types
 
-This is sadly still a marker file.
+There are different execution paths that can be done when executing a distributed search.
+
+	.SearchType(SearchType.Scan)