Update namespace descriptions. (dotnet#90)

Author: natke

dotnet/xml/ns-Microsoft.ML.Calibrators.xml

@@ -1,8 +1,10 @@
 <Namespace Name="Microsoft.ML.Calibrators">
   <Docs>
     <summary>
-      Namespace containing estimators and transformers that take as input the output scores of binary classifiers,
-      and <a href="https://en.wikipedia.org/wiki/Probabilistic_classification#Probability_calibration">calibrate</a> them to produce a probability distribution.
+      Namespace containing components for binary classification <a href="https://en.wikipedia.org/wiki/Probabilistic_classification#Probability_calibration">calibration</a>.
     </summary>
+    <remarks>
+      These components calculate probabilities from scores, for binary classifiers.
+    </remarks>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Data.xml

@@ -1,5 +1,7 @@
 <Namespace Name="Microsoft.ML.Data">
   <Docs>
-    <summary>Namespace containing data loading, data definition and data saving capabilities.</summary>
+    <summary>
+      Namespace containing data loading and saving, data schema definitions, and model training metrics components.
+    </summary>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Runtime.xml

@@ -1,6 +1,7 @@
 <Namespace Name="Microsoft.ML.Runtime">
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>
+      Namespace containing types needed by the ML.NET runtime.
+    </summary>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.SamplesUtils.xml

@@ -1,8 +1,10 @@
 <Namespace Name="Microsoft.ML.SamplesUtils">
   <Docs>
     <summary>
-      Namespace containing utilities to download and featurize datasets for the API reference samples.
-      It is part of the Microsoft.ML.SampleUtils nuget package.
+    Namespace containing utilities to download and featurize datasets for the API reference samples.
     </summary>
+    <remarks>
+    Included in the Microsoft.ML.SampleUtils nuget package.
+    </remarks>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Trainers.FastTree.xml

@@ -1,5 +1,5 @@
 <Namespace Name="Microsoft.ML.Trainers.FastTree">
   <Docs>
-    <summary>Namespace containing estimators, model parameters and other utilities related to the Fast Tree group of trainers.</summary>
+    <summary>Namespace containing trainers, model parameters, and utilities for Fast Tree algorithms.</summary>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Trainers.LightGbm.xml

@@ -1,7 +1,10 @@
 <Namespace Name="Microsoft.ML.Trainers.LightGbm">
   <Docs>
-    <summary>Namespace containing the various <a href="https://lightgbm.readthedocs.io/en/latest/">LightGBM</a> trainers.
-      This namespace is contained in the <a href="https://www.nuget.org/packages/Microsoft.ML.LightGBM/">Microsoft.ML.LightGBM</a> nuget package. 
+    <summary>
+      Namespace containing trainers, model parameters, and utilities for <a href="https://lightgbm.readthedocs.io/en/latest/">LightGBM</a> algorithms.
     </summary>
+    <remarks>
+      Included in the Microsoft.ML.LightGbm nuget package.
+    </remarks>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Trainers.Recommender.xml

@@ -1,7 +1,7 @@
 <Namespace Name="Microsoft.ML.Trainers.Recommender">
   <Docs>
     <summary>
-      Namespace containing estimators and transformers to perform <a href="https://en.wikipedia.org/wiki/Recommender_system">recommendation</a>.
+      Namespace containing trainers, model parameters, and utilities for <a href="https://en.wikipedia.org/wiki/Recommender_system">recommendation</a>.
     </summary>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Trainers.xml

@@ -1,7 +1,7 @@
 <Namespace Name="Microsoft.ML.Trainers">
   <Docs>
-    <summary>The namespace containing the algorithms used for <a href="https://docs.microsoft.com/en-us/dotnet/machine-learning/resources/glossary#training">training</a> a 
-      machine learning model. 
+    <summary>
+      Namespace containing trainers, model parameters, and utilities.
     </summary>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Transforms.Image.xml

@@ -1,8 +1,10 @@
 <Namespace Name="Microsoft.ML.Transforms.Image">
   <Docs>
     <summary>
-      Namespace containing image loading and <a href="https://docs.microsoft.com/en-us/dotnet/machine-learning/resources/glossary#transform">transformation</a> capabilities. 
-      It is contained in the <a href="https://www.nuget.org/packages/Microsoft.ML.ImageAnalytics/">Microsoft.ML.ImageAnalytics nuget package.</a>
+      Namespace containing image loading and transformation components.
     </summary>
+    <remarks>
+      Contained in the Microsoft.ML.ImageAnalytics nuget package.
+    </remarks>
   </Docs>
 </Namespace>

dotnet/xml/ns-Microsoft.ML.Transforms.Onnx.xml

@@ -1,6 +1,7 @@
 <Namespace Name="Microsoft.ML.Transforms.Onnx">
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>
+      Namespace containing <a href="https://onnx.ai/">ONNX</a> model loading and transformation components.
+    </summary>
   </Docs>
 </Namespace>