V10.2.2/service update

.docfx/Dockerfile.docfx

@@ -1,4 +1,4 @@
-ARG NGINX_VERSION=1.31.2-alpine
+ARG NGINX_VERSION=1.31-alpine
 
 FROM --platform=$BUILDPLATFORM nginx:${NGINX_VERSION} AS base
 RUN rm -rf /usr/share/nginx/html/*

.nuget/Codebelt.Extensions.Asp.Versioning/PackageReleaseNotes.txt

@@ -1,3 +1,9 @@
+Version: 10.2.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version: 10.2.1
 Availability: .NET 10 and .NET 9
 

CHANGELOG.md

@@ -7,6 +7,21 @@ For more details, please refer to `PackageReleaseNotes.txt` on a per assembly ba
 > [!NOTE]  
 > Changelog entries prior to version 8.4.0 was migrated from previous versions of Cuemon.Extensions.Asp.Versioning.
 
+## [10.2.2] - 2026-07-24
+
+This is a patch release focused on dependency updates, build toolchain improvements, and documentation quality. The release upgrades core development dependencies to their latest stable patches, enables recommended .NET code analyzers with code style enforcement, configures consistent git tag naming, and refines XML documentation.
+
+### Changed
+
+- Dependencies upgraded to latest stable patches for all supported target frameworks: Codebelt.Extensions.AspNetCore.Mvc.Formatters.Newtonsoft.Json (10.1.5 → 10.1.6), Codebelt.Extensions.AspNetCore.Mvc.Formatters.Text.Yaml (10.1.5 → 10.1.6), Codebelt.Extensions.Xunit.App (11.1.1 → 11.1.2), Cuemon.AspNetCore and related packages (10.5.4 → 10.5.5), and Microsoft.NET.Test.Sdk (18.7.0 → 18.8.1),
+- Build configuration now enables recommended .NET code analyzers with latest analysis level and enforces code style compliance during build,
+- DocFX Dockerfile base image updated from nginx 1.31.2-alpine to nginx 1.31-alpine,
+- MinVerTagPrefix configured to `v` for consistent semantic version tag naming.
+
+### Fixed
+
+- XML documentation improved in `RestfulApiVersionReader` with simplified and modernized parameter documentation using modern type references.
+
 ## [10.2.1] - 2026-07-09
 
 This is a minor release focused on normalizing semantically equivalent API version formats to ensure consistent routing and version matching. Version strings like 1, 1.0, and 1.0.0 are now normalized to identical canonical forms, with automatic enabling when using `SemanticApiVersion` as the default API version.
@@ -193,7 +208,7 @@ This major release is first and foremost focused on ironing out any wrinkles tha
 - RestfulApiVersionReader class in the Codebelt.Extensions.Asp.Versioning namespace that represents a RESTful API version reader that reads the value from a filtered list of HTTP Accept headers in the request
 - RestfulProblemDetailsFactory class in the Codebelt.Extensions.Asp.Versioning namespace that represents a RESTful implementation of the IProblemDetailsFactory which throws variants of HttpStatusCodeException that needs to be translated accordingly
 
-[Unreleased]: https://github.com/codebeltnet/asp-versioning/compare/v10.2.1...HEAD
+[10.2.2]: https://github.com/codebeltnet/asp-versioning/compare/v10.2.1...v10.2.2
 [10.2.1]: https://github.com/codebeltnet/asp-versioning/compare/v10.2.0...v10.2.1
 [10.2.0]: https://github.com/codebeltnet/asp-versioning/compare/v10.1.0...v10.2.0
 [10.1.0]: https://github.com/codebeltnet/asp-versioning/compare/v10.0.9...v10.1.0

Directory.Build.props

@@ -35,7 +35,12 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <SignAssembly Condition="('$(CI)' == 'true' OR '$(IsMainAuthor)' == 'true') AND '$(SkipSignAssembly)' == 'false'">true</SignAssembly>
     <AssemblyOriginatorKeyFile>$(MSBuildThisFileDirectory)versioning.snk</AssemblyOriginatorKeyFile>
-    <NoWarn>7035,CA2260</NoWarn>
+    <EnableNETAnalyzers>true</EnableNETAnalyzers>
+    <AnalysisLevel>latest</AnalysisLevel>
+    <AnalysisMode>Recommended</AnalysisMode>
+    <NoWarn>7035,CA2260,S6618</NoWarn>
+    <MinVerTagPrefix>v</MinVerTagPrefix>
+    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(NuGetPackageRoot)' != ''">
@@ -60,7 +65,7 @@
     <RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
     <SonarQubeExclude>true</SonarQubeExclude>
     <WarningLevel>0</WarningLevel>
-    <AnalysisLevel>none</AnalysisLevel>
+    <AnalysisMode>none</AnalysisMode>
     <NoWarn>NU1701,NETSDK1206</NoWarn>
     <CheckEolTargetFramework>false</CheckEolTargetFramework>
     <UseMicrosoftTestingPlatformRunner>true</UseMicrosoftTestingPlatformRunner>

Directory.Packages.props

@@ -3,14 +3,14 @@
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
   <ItemGroup>
-    <PackageVersion Include="Codebelt.Extensions.AspNetCore.Mvc.Formatters.Newtonsoft.Json" Version="10.1.5" />
-    <PackageVersion Include="Codebelt.Extensions.AspNetCore.Mvc.Formatters.Text.Yaml" Version="10.1.5" />
-    <PackageVersion Include="Codebelt.Extensions.Xunit.App" Version="11.1.1" />
-    <PackageVersion Include="Cuemon.AspNetCore" Version="10.5.4" />
-    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc" Version="10.5.4" />
-    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Json" Version="10.5.4" />
-    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc.Formatters.Xml" Version="10.5.4" />
-    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.7.0" />
+    <PackageVersion Include="Codebelt.Extensions.AspNetCore.Mvc.Formatters.Newtonsoft.Json" Version="10.1.6" />
+    <PackageVersion Include="Codebelt.Extensions.AspNetCore.Mvc.Formatters.Text.Yaml" Version="10.1.6" />
+    <PackageVersion Include="Codebelt.Extensions.Xunit.App" Version="11.1.2" />
+    <PackageVersion Include="Cuemon.AspNetCore" Version="10.5.5" />
+    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc" Version="10.5.5" />
+    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Json" Version="10.5.5" />
+    <PackageVersion Include="Cuemon.Extensions.AspNetCore.Mvc.Formatters.Xml" Version="10.5.5" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.8.1" />
     <PackageVersion Include="MinVer" Version="7.0.0" />
     <PackageVersion Include="coverlet.collector" Version="10.0.1" />
     <PackageVersion Include="coverlet.msbuild" Version="10.0.1" />

src/Codebelt.Extensions.Asp.Versioning/RestfulApiVersionReader.cs

@@ -73,8 +73,7 @@ public override IReadOnlyList<string> Read(HttpRequest request)
         /// <summary>
         /// Reads the requested API version from the HTTP Accept header.
         /// </summary>
-        /// <param name="accept">The <see cref="T:System.Collections.Generic.ICollection`1">collection</see> of Accept
-        /// <see cref="T:Microsoft.Net.Http.Headers.MediaTypeHeaderValue">headers</see> to read from.</param>
+        /// <param name="accept">The <see cref="ICollection{MediaTypeHeaderValue}"/> of Accept headers to read from.</param>
         /// <returns>The API version read or <c>null</c>.</returns>
         /// <remarks>This implementation will, when <see cref="ValidAcceptHeaders"/> has values, filter <paramref name="accept"/> to only include valid <see cref="HeaderNames.Accept"/> headers.</remarks>
         protected override string ReadAcceptHeader(ICollection<MediaTypeHeaderValue> accept)