Improved seat massager sample

dtdl-tools/src/dtdl-validator/DtdlValidator.cs

@@ -16,18 +16,21 @@
 using System.Threading;
 using System.Threading.Tasks;
 
+/// <summary>
+/// The DTDL Validator app.
+/// </summary>
 class Program
 {
     // Exit codes.
     private const int EXIT_SUCCESS = 0;
     private const int EXIT_FAILURE = 1;
 
     /// <summary>
-    /// Convert a DTDL file's path to a DTMI.
+    /// Convert a DTDL file's path to a Digital Twin Model Identifier (DTMI).
     /// </summary>
     /// <param name="dtdlFilePath">The DTDL file's full path.</param>
     /// <param name="dtdlDirPath">The DTDL directory's path.</param>
-    /// <param name="extension">The extensin used by the DTDL files.</param>
+    /// <param name="extension">The extension used by the DTDL files.</param>
     /// <returns>The corresponding DTMI.</returns>
     static string ConvertToDTMI(string dtdlFilePath, string dtdlDirPath, string extension)
     {
@@ -78,7 +81,7 @@ static int ValidateDtdl(DirectoryInfo dtdlDirectory, String extension)
             {
                 string dtmi = ConvertToDTMI(file, dtdlDirectory.FullName, extension);
                 var model = modelRepoClient.GetModelAsync(dtmi).GetAwaiter().GetResult();
-                var dictParsed = parser.ParseAsync(model.Content[dtmi]).GetAwaiter().GetResult();
+                var modelDictionary = parser.ParseAsync(model.Content[dtmi]).GetAwaiter().GetResult();
                 Console.WriteLine($"{file} - ok");
             }
             catch (ParsingException ex)

dtdl-tools/src/dtdl-validator/ModelsRepositoryClientExtensions.cs

@@ -10,8 +10,9 @@ internal static class ModelsRepositoryClientExtensions
 {
     /// <summary>
     /// The Parser's DTMI resolver.
+    /// It asynchronously gets from the models repositpory the DTDL content associated witn each of the provided DTMIs.
     /// </summary>
-    /// <param name="modelRepoClient">The model's repository client.</param>
+    /// <param name="modelRepoClient">The models repository client.</param>
     /// <param name="dtmis"></param>
     /// <param name="cancellationToken">The cancellation topken.</param>
     /// <returns>The model definitions for the provided DTMIs.</returns>