Add xmldoc to LogMessage

Author: jviau

src/Azure.Functions.Sdk/LogMessage.cs

@@ -8,27 +8,51 @@ namespace Azure.Functions.Sdk;
 
 internal readonly struct LogMessage
 {
+    /// <summary>
+    /// Log message for when the Func CLI cannot be run.
+    /// </summary>
     public static readonly LogMessage Error_CannotRunFuncCli
         = new(nameof(Strings.AZFW0100_Error_CannotRunFuncCli));
 
+    /// <summary>
+    /// Log message for when there is a conflict between extension packages.
+    /// </summary>
     public static readonly LogMessage Error_ExtensionPackageConflict
         = new(nameof(Strings.AZFW0101_Error_ExtensionPackageConflict));
 
+    /// <summary>
+    /// Log message for when there is a duplicate extension package.
+    /// </summary>
     public static readonly LogMessage Warning_ExtensionPackageDuplicate
         = new(nameof(Strings.AZFW0102_Warning_ExtensionPackageDuplicate));
 
+    /// <summary>
+    /// Log message for when an extension package version is invalid.
+    /// </summary>
     public static readonly LogMessage Error_InvalidExtensionPackageVersion
         = new(nameof(Strings.AZFW0103_Error_InvalidExtensionPackageVersion));
 
+    /// <summary>
+    /// Log message for when an end-of-life Functions version is used.
+    /// </summary>
     public static readonly LogMessage Warning_EndOfLifeFunctionsVersion
         = new(nameof(Strings.AZFW0104_Warning_EndOfLifeFunctionsVersion));
 
+    /// <summary>
+    /// Log message for when an incompatible Functions SDK is used.
+    /// </summary>
     public static readonly LogMessage Error_UsingIncompatibleSdk
         = new(nameof(Strings.AZFW0105_Error_UsingIncompatibleSdk));
 
+    /// <summary>
+    /// Log message for when an unknown Functions version is specified.
+    /// </summary>
     public static readonly LogMessage Error_UnknownFunctionsVersion
         = new(nameof(Strings.AZFW0106_Error_UnknownFunctionsVersion));
 
+    /// <summary>
+    /// Log message for when an unsupported target framework is used.
+    /// </summary>
     public static readonly LogMessage Warning_UnsupportedTargetFramework
         = new(nameof(Strings.AZFW0107_Warning_UnsupportedTargetFramework));
 
@@ -59,12 +83,33 @@ public LogMessage(LogLevel level, string id, string? code = null)
         Code = code;
     }
 
+    /// <summary>
+    /// Gets the level of the log message.
+    /// </summary>
     public LogLevel Level { get; }
 
+    /// <summary>
+    /// Gets the identifier of the log message.
+    /// </summary>
+    /// <remarks>
+    /// This identifier must correspond to a resource string in the <see cref="Strings"/> resource file.
+    /// </remarks>
     public string Id { get; }
 
+    /// <summary>
+    /// Gets the code of the log message, if available.
+    /// </summary>
     public string? Code { get; }
 
+    /// <summary>
+    /// Gets the help keyword for the log message.
+    /// </summary>
+    /// <remarks>
+    /// The help keyword is derived from the <see cref="Code"/> property.
+    /// If the <see cref="Code"/> is null, the help keyword will also be null.
+    /// A help keyword will emit a help link of "https://go.microsoft.com/fwlink/?LinkId=AzureFunctions.{Code}"
+    /// as part of the msbuild log.
+    /// </remarks>
     public string? HelpKeyword => Code is null ? null : $"AzureFunctions.{Code}";
 
     /// <summary>