review comments - 2. updating comments, help summary etc

Author: abgoswam

src/Microsoft.ML.FastTree/FastTreeArguments.cs

@@ -27,9 +27,9 @@ public sealed partial class FastTreeBinaryClassificationTrainer
         public sealed class Options : BoostedTreeArgs, IFastTreeTrainerFactory
         {
             /// <summary>
-            /// Should we use derivatives optimized for unbalanced sets?
+            /// Option for using derivatives optimized for unbalanced sets.
             /// </summary>
-            [Argument(ArgumentType.LastOccurenceWins, HelpText = "Should we use derivatives optimized for unbalanced sets", ShortName = "us")]
+            [Argument(ArgumentType.LastOccurenceWins, HelpText = "Option for using derivatives optimized for unbalanced sets", ShortName = "us")]
             [TGUI(Label = "Optimize for unbalanced")]
             public bool UnbalancedSets = false;
 
@@ -448,9 +448,9 @@ public abstract class BoostedTreeArgs : TreeArgs
         //Use the second derivative for split gains (not just outputs). Use MaxTreeOutput to "clip" cases where the second derivative is too close to zero.
         //Turning BSR on makes larger steps in initial stages and converges to better results with fewer trees (though in the end, it asymptotes to the same results).
         /// <summary>
-        /// Use best regression step trees?
+        /// Option for using best regression step trees.
         /// </summary>
-        [Argument(ArgumentType.LastOccurenceWins, HelpText = "Use best regression step trees?", ShortName = "bsr")]
+        [Argument(ArgumentType.LastOccurenceWins, HelpText = "Option for using best regression step trees", ShortName = "bsr")]
         public bool BestStepRankingRegressionTrees = false;
 
         /// <summary>

src/Microsoft.ML.FastTree/FastTreeClassification.cs

@@ -142,7 +142,7 @@ public FastTreeBinaryClassificationTrainer(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastTreeBinaryClassificationTrainer"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastTreeBinaryClassificationTrainer"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastTreeBinaryClassificationTrainer(IHostEnvironment env, Options args)
             : base(env, args, TrainerUtils.MakeBoolScalarLabel(args.LabelColumn))

src/Microsoft.ML.FastTree/FastTreeRanking.cs

@@ -86,7 +86,7 @@ public FastTreeRankingTrainer(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastTreeRankingTrainer"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastTreeRankingTrainer"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastTreeRankingTrainer(IHostEnvironment env, Options args)
         : base(env, args, TrainerUtils.MakeR4ScalarColumn(args.LabelColumn))

src/Microsoft.ML.FastTree/FastTreeRegression.cs

@@ -75,7 +75,7 @@ public FastTreeRegressionTrainer(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastTreeRegressionTrainer"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastTreeRegressionTrainer"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastTreeRegressionTrainer(IHostEnvironment env, Options args)
             : base(env, args, TrainerUtils.MakeR4ScalarColumn(args.LabelColumn))

src/Microsoft.ML.FastTree/FastTreeTweedie.cs

@@ -76,7 +76,7 @@ public FastTreeTweedieTrainer(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastTreeTweedieTrainer"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastTreeTweedieTrainer"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastTreeTweedieTrainer(IHostEnvironment env, Options args)
             : base(env, args, TrainerUtils.MakeR4ScalarColumn(args.LabelColumn))

src/Microsoft.ML.FastTree/RandomForestClassification.cs

@@ -160,7 +160,7 @@ public FastForestClassification(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastForestClassification"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastForestClassification"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastForestClassification(IHostEnvironment env, Options args)
             : base(env, args, TrainerUtils.MakeBoolScalarLabel(args.LabelColumn))

src/Microsoft.ML.FastTree/RandomForestRegression.cs

@@ -178,7 +178,7 @@ public FastForestRegression(IHostEnvironment env,
         }
 
         /// <summary>
-        /// Initializes a new instance of <see cref="FastForestRegression"/> by using the legacy <see cref="Options"/> class.
+        /// Initializes a new instance of <see cref="FastForestRegression"/> by using the <see cref="Options"/> class.
         /// </summary>
         public FastForestRegression(IHostEnvironment env, Options args)
             : base(env, args, TrainerUtils.MakeR4ScalarColumn(args.LabelColumn), true)