Fix XML comments and documentation structure

This commit fixes XML comments, corrects file names and sets the correct
section header level for generated documentation.

Author: russcam

build/scripts/Commandline.fsx

@@ -41,6 +41,7 @@ NOTE: both the `test` and `integrate` targets can be suffixed with `-all` to for
 Execution hints can be provided anywhere on the command line
 - skiptests : skip running tests as part of the target chain
 - skipdocs : skip generating documentation
+- docs:<B> : the branch name B to use when generating documentation
 - seed:<N> : provide a seed to run the tests with.
 - random:<K><:B> : sets random K to bool B if if B is omitted will default to true
   K can be: sourceserializer, typedkeys or oldconnection (only valid on windows)

src/Nest/Search/Search/Collapsing/FieldCollapse.cs

@@ -70,7 +70,7 @@ public FieldCollapseDescriptor<T> MaxConcurrentGroupSearches(int? maxConcurrentG
 		/// <inheritdoc cref="IFieldCollapse.Field"/>
 		public FieldCollapseDescriptor<T> Field(Expression<Func<T, object>> objectPath) => Assign(a => a.Field = objectPath);
 
-		/// <inheritdoc cref="IFieldCollapse.InnherHits"/>
+		/// <inheritdoc cref="IFieldCollapse.InnerHits"/>
 		public FieldCollapseDescriptor<T> InnerHits(Func<InnerHitsDescriptor<T>, IInnerHits> selector = null) =>
 			Assign(a => a.InnerHits = selector.InvokeOrDefault(new InnerHitsDescriptor<T>()));
 

src/Tests/Tests/Aggregations/Bucket/Composite/CompositeAggregationUsageTests.cs

@@ -197,7 +197,7 @@ protected override void ExpectResponse(ISearchResponse<Project> response)
 	}
 
 	/**[float]
-	* == Missing buckets
+	* === Missing buckets
 	* By default documents without a value for a given source are ignored.
 	* It is possible to include them in the response by setting missing_bucket to `true` (defaults to `false`):
 	*

src/Tests/Tests/Aggregations/Bucket/DateHistogram/DateHistogramAggregationUsageTests.cs

@@ -112,7 +112,7 @@ public DateHistogramAggregationUsageTests(ReadOnlyCluster i, EndpointUsage usage
 
 		protected override void ExpectResponse(ISearchResponse<Project> response)
 		{
-			/** === Handling responses
+			/** ==== Handling responses
 			* The `AggregateDictionary found on `.Aggregations` on `ISearchResponse<T>` has several helper methods
 			* so we can fetch our aggregation results easily in the correct type.
 			 * <<handling-aggregate-response, Be sure to read more about these helper methods>>

src/Tests/Tests/Aggregations/Bucket/DateRange/DateRangeAggregationUsageTests.cs

@@ -79,7 +79,7 @@ public DateRangeAggregationUsageTests(ReadOnlyCluster i, EndpointUsage usage) :
 
 		protected override void ExpectResponse(ISearchResponse<Project> response)
 		{
-			/** === Handling Responses
+			/** ==== Handling Responses
 			* The `AggregateDictionary found on `.Aggregations` on `ISearchResponse<T>` has several helper methods
 			* so we can fetch our aggregation results easily in the correct type.
 			 * <<handling-aggregate-response, Be sure to read more about these helper methods>>

src/Tests/Tests/Aggregations/Bucket/Filter/FilterAggregationUsageTests.cs

@@ -62,7 +62,7 @@ public FilterAggregationUsageTests(ReadOnlyCluster i, EndpointUsage usage) : bas
 
 		protected override void ExpectResponse(ISearchResponse<Project> response)
 		{
-			/** === Handling Responses
+			/** ==== Handling Responses
 			* The `AggregateDictionary found on `.Aggregations` on `ISearchResponse<T>` has several helper methods
 			* so we can fetch our aggregation results easily in the correct type.
 			 * <<handling-aggregate-response, Be sure to read more about these helper methods>>
@@ -79,7 +79,7 @@ protected override void ExpectResponse(ISearchResponse<Project> response)
 	}
 
 	/**[float]
-	* == Empty Filter
+	* === Empty Filter
 	* When the collection of filters is empty or all are conditionless, NEST will serialize them
 	* to an empty object.
 	*/
@@ -124,6 +124,7 @@ protected override void ExpectResponse(ISearchResponse<Project> response)
 	}
 
 	//reproduce of https://github.com/elastic/elasticsearch-net/issues/1931
+	// hide
 	public class InlineScriptFilterAggregationUsageTests : AggregationUsageTestBase
 	{
 		private string _ctxNumberofCommits = "doc['numberOfCommits'].value > 0";