PR feedback.

Author: codemzs

src/Microsoft.ML.Mkl.Components/MklComponentsCatalog.cs

@@ -15,11 +15,11 @@ namespace Microsoft.ML
     public static class MklComponentsCatalog
     {
         /// <summary>
-        /// Creates a <see cref="OlsTrainer"/>, which predicts a target using a linear regression model.
+        /// Creates <see cref="OlsTrainer"/>, which predicts a target using a linear regression model.
         /// </summary>
         /// <param name="catalog">The <see cref="RegressionCatalog"/>.</param>
-        /// <param name="labelColumnName">The name of the label column. The column data must be <see cref="System.Single"/></param>
-        /// <param name="featureColumnName">The name of the feature column. The column data must be a known-sized vector of <see cref="System.Single"/></param>
+        /// <param name="labelColumnName">The name of the label column. The column data must be <see cref="System.Single"/>.</param>
+        /// <param name="featureColumnName">The name of the feature column. The column data must be a known-sized vector of <see cref="System.Single"/>.</param>
         /// <param name="exampleWeightColumnName">The name of the example weight column (optional).</param>
         /// <example>
         /// <format type="text/markdown">
@@ -46,7 +46,7 @@ public static OlsTrainer Ols(this RegressionCatalog.RegressionTrainers catalog,
         }
 
         /// <summary>
-        ///  Creates a <see cref="OlsTrainer"/>, which predicts a target using a linear regression model with advanced options.
+        /// Create <see cref="OlsTrainer"/> using advanced options, which predicts a target using a linear regression model.
         /// </summary>
         /// <param name="catalog">The <see cref="RegressionCatalog"/>.</param>
         /// <param name="options">Algorithm advanced options. See <see cref="OlsTrainer.Options"/>.</param>

src/Microsoft.ML.Mkl.Components/OlsLinearRegression.cs

@@ -37,8 +37,8 @@ namespace Microsoft.ML.Trainers
     /// </summary>
     /// <remarks>
     /// <format type="text/markdown"><![CDATA[
-    /// To create this trainer, use [Ols](xref:Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers, System.String, System.String, System.String))
-    /// or [Ols(Options)](xref:Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers, Microsoft.ML.Trainers.OlsTrainer.Options)).
+    /// To create this trainer, use [Ols](xref:Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers,System.String,System.String,System.String))
+    /// or [Ols(Options)](xref:Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers,Microsoft.ML.Trainers.OlsTrainer.Options)).
     ///
     /// [!include[io](~/../docs/samples/docs/api-reference/io-columns-regression.md)]
     ///
@@ -57,13 +57,14 @@ namespace Microsoft.ML.Trainers
     /// ]]>
     /// </format>
     /// </remarks>
-    /// <seealso cref="Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers, System.String, System.String, System.String)"/>
-    /// <seealso cref="Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers, Microsoft.ML.Trainers.OlsTrainer.Options)"/>
+    /// <seealso cref="MklComponentsCatalog.Ols(RegressionCatalog.RegressionTrainers, string, string, string)"/>
+    /// <seealso cref="MklComponentsCatalog.Ols(RegressionCatalog.RegressionTrainers, OlsTrainer.Options)"/>
     /// <seealso cref="Options"/>
     public sealed class OlsTrainer : TrainerEstimatorBase<RegressionPredictionTransformer<OlsModelParameters>, OlsModelParameters>
     {
         /// <summary>
-        /// Options for the <see cref="OlsTrainer"/>.
+        /// Options for the <see cref="OlsTrainer"/> as used in
+        /// [Ols(Options)](xref:Microsoft.ML.MklComponentsCatalog.Ols(Microsoft.ML.RegressionCatalog.RegressionTrainers,Microsoft.ML.Trainers.OlsTrainer.Options))
         /// </summary>
         public sealed class Options : TrainerInputBaseWithWeight
         {