The Microsoft.WindowsAppSDK.AI NuGet package currently ships .winmd metadata files but does not include the corresponding .xml documentation files (C# XML doc format).
Other WinAppSDK sub-packages already ship .xml alongside .winmd:
| Package |
XML Docs Included |
| Microsoft.WindowsAppSDK.Foundation |
Partial |
| Microsoft.WindowsAppSDK.WinUI |
Yes |
| Microsoft.WindowsAppSDK.Widgets |
Yes |
| Microsoft.WindowsAppSDK.AI |
No |
| Microsoft.WindowsAppSDK.ML |
No |
| Microsoft.WindowsAppSDK.Search |
No |
For comparison, other WinAppSDK packages already include XML documentation files alongside .winmd.
Microsoft.WindowsAppSDK.Foundation includes both .winmd and .xml files:
In contrast, Microsoft.WindowsAppSDK.AI currently only includes .winmd files, with no corresponding .xml documentation:
Impact
Poor IntelliSense experience in Visual Studio and VS Code
Without .xml files, API descriptions are missing or minimal in IntelliSense, making it harder for developers to understand and use the APIs effectively.
Without .xml files, generated bindings lack API documentation:
With .xml documentation present, generated bindings include rich descriptions:
The Microsoft.WindowsAppSDK.AI NuGet package currently ships .winmd metadata files but does not include the corresponding .xml documentation files (C# XML doc format).
Other WinAppSDK sub-packages already ship .xml alongside .winmd:
For comparison, other WinAppSDK packages already include XML documentation files alongside
.winmd.Microsoft.WindowsAppSDK.Foundation includes both
.winmdand.xmlfiles:In contrast, Microsoft.WindowsAppSDK.AI currently only includes
.winmdfiles, with no corresponding.xmldocumentation:Impact
Poor IntelliSense experience in Visual Studio and VS Code
Without
.xmlfiles, API descriptions are missing or minimal in IntelliSense, making it harder for developers to understand and use the APIs effectively.Without
.xmlfiles, generated bindings lack API documentation:With
.xmldocumentation present, generated bindings include rich descriptions: