Fix release CI warnings (#6)

Add XML documentation for the image converter APIs reported by CI.
Suppress CS1591 during generated XML documentation builds so existing undocumented public APIs do not flood release builds.
Pin Windows GitHub Actions jobs to windows-2022 to avoid the upcoming windows-latest image migration notice.

Author: tobitege

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ on:
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: windows-2022
     steps:
       - uses: actions/checkout@v6
 

.github/workflows/release.yml

@@ -39,7 +39,7 @@ jobs:
 
   build-desktop:
     needs: validate
-    runs-on: windows-latest
+    runs-on: windows-2022
     permissions:
       contents: read
 

Directory.Build.targets

@@ -0,0 +1,6 @@
+<Project>
+  <PropertyGroup Condition="'$(GenerateDocumentationFile)'=='true'">
+    <!-- XML docs are generated for release packages, but not every public API is documented yet. -->
+    <NoWarn>$(NoWarn);CS1591</NoWarn>
+  </PropertyGroup>
+</Project>

OpenSourceToolkit.Converters/ImageConverter.cs

@@ -1,14 +1,23 @@
-using System;
+using System;
 using System.Drawing;
 using System.Drawing.Imaging;
 using System.IO;
 using System.Runtime.Versioning;
 
 namespace OpenSourceToolkit.Converters
 {
+    /// <summary>
+    /// Provides basic image conversion helpers for file and byte-array inputs.
+    /// </summary>
     [SupportedOSPlatform("windows")]
     public static class ImageConverter
     {
+        /// <summary>
+        /// Converts an image file to the specified output format.
+        /// </summary>
+        /// <param name="inputPath">Path to the source image file.</param>
+        /// <param name="outputPath">Path where the converted image should be saved.</param>
+        /// <param name="format">Image format to use for the output file.</param>
         public static void Convert(string inputPath, string outputPath, ImageFormat format)
         {
             using (var image = Image.FromFile(inputPath))
@@ -17,6 +26,12 @@ public static void Convert(string inputPath, string outputPath, ImageFormat form
             }
         }
 
+        /// <summary>
+        /// Converts image bytes to the specified output format.
+        /// </summary>
+        /// <param name="inputBytes">Source image bytes.</param>
+        /// <param name="format">Image format to use for the converted bytes.</param>
+        /// <returns>The converted image bytes.</returns>
         public static byte[] Convert(byte[] inputBytes, ImageFormat format)
         {
             using (var inputStream = new MemoryStream(inputBytes))