The Wire · Showcase
MACIOS DOCS OVERHAUL SPANS 31 TYPES, ASPNETCORE VALIDATION MOVES TO SOURCE GENERATION
By RepoJournal · Filed · About .NET
Rolf Bjarne shipped 31 types with proper XML documentation across macios while aspnetcore refactors validation classes out of the public API entirely.
The macios team completed a two-part documentation push covering NSValue, ARFaceGeometry, CAMediaTimingFunction, and 28 other framework types, replacing placeholder 'To be added' remarks with meaningful descriptions and removing empty nodes [1][2]. Over in aspnetcore, validation infrastructure is moving out of Microsoft.Extensions.Validation as source-generated file classes in user assemblies, eliminating abstract base classes from the public surface and simplifying the implementation [3]. The same team also fixed OpenAPI parameter matching to respect IModelNameProvider attributes, ensuring CancellationToken and FromServices parameters no longer pollute request body documentation [4]. Roslyn fixed a null reference crash when opening XAML documents that lack view adapters and optimized CI by switching desktop test jobs from Release_32 to Release_64 on PRs [5][6]. Maui added 10.0.90 and 11.0.0-preview.6 to bug report templates and improved release-readiness guidance for backports and version transitions [7].
One email a day. Unsubscribe in one click.
Keep up with .NET in about 3 minutes a day: what actually shipped — the commits, pull requests, releases, and security advisories that matter.
One email a day. Unsubscribe in one click. Read a past issue →
Action items
- → Review OpenAPI parameter matching changes if you generate Swagger docs from ASP.NET Core endpoints dotnet/aspnetcore [plan]
- → Test validation source generation if using Microsoft.Extensions.Validation in preview dotnet/aspnetcore [plan]
- → Monitor maui release-readiness flow for new backport guidance dotnet/maui [monitor]
References
- [1] [docs] Improve XML docs for NSCollectionViewLayout, NSPasteboard, NSSharingService, ARPointCloud, CAMediaTimingFunction, CFType, CGPattern, AVAssetDownloadTask, AVOutputSettingsAssistant, CFMachPortCo ↗ dotnet/macios
- [2] [docs] Improve XML docs for 19 types (NSValue, MessageComposeResult, ABRecord, etc.) ↗ dotnet/macios
- [3] Move the abstract `Validatable*Info` from Microsoft.Extensions.Validation to be source-generated ↗ dotnet/aspnetcore
- [4] Respect IModelNameProvider when matching OpenAPI parameters ↗ dotnet/aspnetcore
- [5] Avoid nullref when opening XAML documents with no view adapter (#84595) dotnet/roslyn
- [6] CI desktop test jobs: run Release_64 instead of Release_32 on PRs. Delete Debug_32 job. (#84598) dotnet/roslyn
- [7] Add new versions to the bug report template (#36740) dotnet/maui