Add positive_score_impact to rank_features property (#5607) (#5614)

(cherry picked from commit e2b2eda)

Author: stevejgordon

src/Nest/Mapping/Types/Core/RankFeatures/RankFeaturesAttribute.cs

@@ -8,5 +8,16 @@ namespace Nest
 	public class RankFeaturesAttribute : ElasticsearchPropertyAttributeBase, IRankFeaturesProperty
 	{
 		public RankFeaturesAttribute() : base(FieldType.RankFeatures) { }
+
+		private IRankFeaturesProperty Self => this;
+
+		/// <inheritdoc cref="IRankFeatureProperty.PositiveScoreImpact"/>
+		public bool PositiveScoreImpact
+		{
+			get => Self.PositiveScoreImpact.GetValueOrDefault(true);
+			set => Self.PositiveScoreImpact = value;
+		}
+
+		bool? IRankFeaturesProperty.PositiveScoreImpact { get; set; }
 	}
 }

src/Nest/Mapping/Types/Core/RankFeatures/RankFeaturesProperty.cs

@@ -4,6 +4,7 @@
 
 using System.Diagnostics;
 using Nest.Utf8Json;
+using System.Runtime.Serialization;
 
 namespace Nest
 {
@@ -15,20 +16,37 @@ namespace Nest
 	[InterfaceDataContract]
 	public interface IRankFeaturesProperty : IProperty
 	{
+		/// <summary>
+		/// Rank features that correlate negatively with the score should set <see cref="PositiveScoreImpact"/>
+		/// to false (defaults to true). This will be used by the rank_features query to modify the scoring
+		/// formula in such a way that the score decreases with the value of the feature instead of
+		/// increasing.
+		/// </summary>
+		[DataMember(Name = "positive_score_impact")]
+		bool? PositiveScoreImpact { get; set; }
 	}
 
 	/// <inheritdoc cref="IRankFeaturesProperty" />
 	public class RankFeaturesProperty : PropertyBase, IRankFeaturesProperty
 	{
 		public RankFeaturesProperty() : base(FieldType.RankFeatures) { }
+
+		/// <inheritdoc />
+		public bool? PositiveScoreImpact { get; set; }
 	}
 
 	/// <inheritdoc cref="IRankFeaturesProperty" />
-	[DebuggerDisplay("{DebugDisplay}")]
+	[DebuggerDisplay("{" + nameof(DebugDisplay) + "}")]
 	public class RankFeaturesPropertyDescriptor<T>
 		: PropertyDescriptorBase<RankFeaturesPropertyDescriptor<T>, IRankFeaturesProperty, T>, IRankFeaturesProperty
 		where T : class
 	{
 		public RankFeaturesPropertyDescriptor() : base(FieldType.RankFeatures) { }
+		
+		bool? IRankFeaturesProperty.PositiveScoreImpact { get; set; }
+
+		/// <inheritdoc cref="IRankFeaturesProperty.PositiveScoreImpact" />
+		public RankFeaturesPropertyDescriptor<T> PositiveScoreImpact(bool? positiveScoreImpact = true) =>
+			Assign(positiveScoreImpact, (a, v) => a.PositiveScoreImpact = v);
 	}
 }