Update documentation

Author: russcam

docs/aggregations.asciidoc

@@ -138,6 +138,8 @@ In addition to the buckets themselves, the bucket aggregations also compute and
 
 * <<significant-terms-aggregation-usage,Significant Terms Aggregation Usage>>
 
+* <<significant-text-aggregation-usage,Significant Text Aggregation Usage>>
+
 * <<terms-aggregation-usage,Terms Aggregation Usage>>
 
 [NOTE]
@@ -187,6 +189,8 @@ include::aggregations/bucket/sampler/sampler-aggregation-usage.asciidoc[]
 
 include::aggregations/bucket/significant-terms/significant-terms-aggregation-usage.asciidoc[]
 
+include::aggregations/bucket/significant-text/significant-text-aggregation-usage.asciidoc[]
+
 include::aggregations/bucket/terms/terms-aggregation-usage.asciidoc[]
 
 [[pipeline-aggregations]]
@@ -203,6 +207,8 @@ There are many different types of pipeline aggregation, each computing different
 
 * <<bucket-selector-aggregation-usage,Bucket Selector Aggregation Usage>>
 
+* <<bucket-sort-aggregation-usage,Bucket Sort Aggregation Usage>>
+
 * <<cumulative-sum-aggregation-usage,Cumulative Sum Aggregation Usage>>
 
 * <<derivative-aggregation-usage,Derivative Aggregation Usage>>
@@ -241,6 +247,8 @@ include::aggregations/pipeline/bucket-script/bucket-script-aggregation-usage.asc
 
 include::aggregations/pipeline/bucket-selector/bucket-selector-aggregation-usage.asciidoc[]
 
+include::aggregations/pipeline/bucket-sort/bucket-sort-aggregation-usage.asciidoc[]
+
 include::aggregations/pipeline/cumulative-sum/cumulative-sum-aggregation-usage.asciidoc[]
 
 include::aggregations/pipeline/derivative/derivative-aggregation-usage.asciidoc[]

docs/aggregations/aggregation-meta-usage.asciidoc

@@ -17,6 +17,8 @@ please modify the original csharp file found at the link and submit the PR with
 
 Metadata can be provided per aggregation, and will be returned in the aggregation response
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -30,6 +32,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new MinAggregation("min_last_activity", Infer.Field<Project>(p => p.LastActivity))

docs/aggregations/bucket/adjacency-matrix/adjacency-matrix-usage.asciidoc

@@ -15,6 +15,8 @@ please modify the original csharp file found at the link and submit the PR with
 [[adjacency-matrix-usage]]
 === Adjacency Matrix Usage
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -27,6 +29,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new AdjacencyMatrixAggregation("interactions")

docs/aggregations/bucket/children/children-aggregation-usage.asciidoc

@@ -20,6 +20,8 @@ buckets on child documents.
 
 Be sure to read the Elasticsearch documentation on {ref_current}/search-aggregations-bucket-children-aggregation.html[Children Aggregation]
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -32,6 +34,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new ChildrenAggregation("name_of_child_agg", typeof(CommitActivity))

docs/aggregations/bucket/date-histogram/date-histogram-aggregation-usage.asciidoc

@@ -25,6 +25,8 @@ as part of the `format` value.
 
 Be sure to read the Elasticsearch documentation on {ref_current}/search-aggregations-bucket-datehistogram-aggregation.html[Date Histogram Aggregation].
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -47,6 +49,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new DateHistogramAggregation("projects_started_per_month")

docs/aggregations/bucket/date-range/date-range-aggregation-usage.asciidoc

@@ -23,6 +23,8 @@ IMPORTANT: this aggregation includes the `from` value and excludes the `to` valu
 
 Be sure to read the Elasticsearch documentation on {ref_current}/search-aggregations-bucket-daterange-aggregation.html[Date Range Aggregation]
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -40,6 +42,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new DateRangeAggregation("projects_date_ranges")

docs/aggregations/bucket/filter/filter-aggregation-usage.asciidoc

@@ -20,6 +20,8 @@ Often this will be used to narrow down the current aggregation context to a spec
 
 Be sure to read the Elasticsearch documentation on {ref_current}/search-aggregations-bucket-filter-aggregation.html[Filter Aggregation]
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -31,6 +33,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FilterAggregation("bethels_projects")
@@ -90,6 +94,8 @@ tags.Buckets.Should().NotBeEmpty();
 When the collection of filters is empty or all are conditionless, NEST will serialize them
 to an empty object.
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -102,6 +108,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FilterAggregation("empty_filter")
@@ -123,11 +131,15 @@ new FilterAggregation("empty_filter")
 }
 ----
 
+==== Handling Responses
+
 [source,csharp]
 ----
 response.ShouldNotBeValid();
 ----
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -140,6 +152,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FilterAggregation(_aggName)
@@ -167,6 +181,8 @@ new FilterAggregation(_aggName)
 }
 ----
 
+==== Handling Responses
+
 [source,csharp]
 ----
 response.ShouldBeValid();

docs/aggregations/bucket/filters/filters-aggregation-usage.asciidoc

@@ -24,6 +24,8 @@ Be sure to read the Elasticsearch documentation {ref_current}/search-aggregation
 [float]
 === Named filters
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -41,6 +43,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FiltersAggregation("projects_by_state")
@@ -134,6 +138,8 @@ namedResult.DocCount.Should().Be(0);
 [float]
 === Anonymous filters
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -150,6 +156,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FiltersAggregation("projects_by_state")
@@ -235,6 +243,8 @@ results.Last().DocCount.Should().Be(0); <1>
 [float]
 === Empty Filters
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -243,6 +253,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FiltersAggregation("empty_filters")
@@ -263,6 +275,8 @@ new FiltersAggregation("empty_filters")
 }
 ----
 
+==== Handling Responses
+
 [source,csharp]
 ----
 response.ShouldBeValid();
@@ -272,6 +286,8 @@ response.Aggregations.Filters("empty_filters").Buckets.Should().BeEmpty();
 [float]
 === Conditionless Filters 
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -282,6 +298,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new FiltersAggregation("conditionless_filters")
@@ -305,6 +323,8 @@ new FiltersAggregation("conditionless_filters")
 }
 ----
 
+==== Handling Responses
+
 [source,csharp]
 ----
 response.ShouldBeValid();

docs/aggregations/bucket/geo-distance/geo-distance-aggregation-usage.asciidoc

@@ -15,6 +15,8 @@ please modify the original csharp file found at the link and submit the PR with
 [[geo-distance-aggregation-usage]]
 === Geo Distance Aggregation Usage
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -29,6 +31,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new GeoDistanceAggregation("rings_around_amsterdam")

docs/aggregations/bucket/geo-hash-grid/geo-hash-grid-aggregation-usage.asciidoc

@@ -15,6 +15,8 @@ please modify the original csharp file found at the link and submit the PR with
 [[geo-hash-grid-aggregation-usage]]
 === Geo Hash Grid Aggregation Usage
 
+==== Fluent DSL example
+
 [source,csharp]
 ----
 a => a
@@ -26,6 +28,8 @@ a => a
 )
 ----
 
+==== Object Initializer syntax example
+
 [source,csharp]
 ----
 new GeoHashGridAggregation("my_geohash_grid")