Develop

LanguageTags/Iso6392Data.cs

@@ -89,10 +89,11 @@ internal static void GenCode(string fileName, Iso6392Data iso6392)
         _ = stringBuilder
             .Append(
                 """
-                // This file is generated by LanguageTagsCreate
-
                 namespace ptr727.LanguageTags;
 
+                /// <summary>
+                /// Provides access to ISO 639-2 language code data.
+                /// </summary>
                 public partial class Iso6392Data
                 {
                     public static Iso6392Data Create() =>

LanguageTags/Iso6392DataGen.cs

@@ -1,7 +1,8 @@
-// This file is generated by LanguageTagsCreate
-
 namespace ptr727.LanguageTags;
 
+/// <summary>
+/// Provides access to ISO 639-2 language code data.
+/// </summary>
 public partial class Iso6392Data
 {
     public static Iso6392Data Create() =>

LanguageTags/Iso6393Data.cs

@@ -113,10 +113,11 @@ internal static void GenCode(string fileName, Iso6393Data iso6393)
         _ = stringBuilder
             .Append(
                 """
-                // This file is generated by LanguageTagsCreate
-
                 namespace ptr727.LanguageTags;
 
+                /// <summary>
+                /// Provides access to ISO 639-3 language code data.
+                /// </summary>
                 public partial class Iso6393Data
                 {
                     public static Iso6393Data Create() =>
@@ -147,6 +148,7 @@ public static Iso6393Data Create() =>
                                         RefName = {{LanguageSchema.GetCodeGenString(
                         record.RefName
                     )}},
+                                    },
                     """
                 )
                 .Append("\r\n");

LanguageTags/Iso6393DataGen.cs

@@ -1,7 +1,8 @@
-// This file is generated by LanguageTagsCreate
-
 namespace ptr727.LanguageTags;
 
+/// <summary>
+/// Provides access to ISO 639-3 language code data.
+/// </summary>
 public partial class Iso6393Data
 {
     public static Iso6393Data Create() =>
@@ -25934,7 +25935,6 @@ public static Iso6393Data Create() =>
                     Scope = "M",
                     LanguageType = "L",
                     RefName = "Serbo-Croatian",
-                    Comment = "Code element for 639-1 has been deprecated",
                 },
                 new()
                 {

LanguageTags/LanguageTags.csproj

@@ -29,6 +29,10 @@
     <TargetFramework>net10.0</TargetFramework>
     <Version>1.0.0.0</Version>
   </PropertyGroup>
+  <PropertyGroup>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <NoWarn>$(NoWarn);1591</NoWarn>
+  </PropertyGroup>
   <ItemGroup>
     <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
   </ItemGroup>

LanguageTags/Rfc5646Data.cs

@@ -77,12 +77,13 @@ internal static void GenCode(string fileName, Rfc5646Data rfc5646)
             .Append(
                 CultureInfo.InvariantCulture,
                 $$"""
-                // This file is generated by LanguageTagsCreate
-
                 using System;
 
                 namespace ptr727.LanguageTags;
 
+                /// <summary>
+                /// Provides access to RFC 5646 / BCP 47 language subtag registry data.
+                /// </summary>
                 public partial class Rfc5646Data
                 {
                     public static Rfc5646Data Create() =>

LanguageTags/Rfc5646DataGen.cs

@@ -1,9 +1,10 @@
-// This file is generated by LanguageTagsCreate
-
 using System;
 
 namespace ptr727.LanguageTags;
 
+/// <summary>
+/// Provides access to RFC 5646 / BCP 47 language subtag registry data.
+/// </summary>
 public partial class Rfc5646Data
 {
     public static Rfc5646Data Create() =>