-
Notifications
You must be signed in to change notification settings - Fork 1.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add missing MAUI API docs #7463
Comments
Good point. A lot of MAUI API misses documentation. For example MAUI Graphics code as well. I had to look up the source code on GitHub to be able to find out how it works for every function I use. ( Edit: I'm always on the latest MAUI |
BTW in .NET MAUI 6 GA (that we released this week) you should see a TON more documentation for APIs. It's certainly not complete, but prior to that, there were ZERO docs visible for the main MAUI APIs. |
@Eilon Neither is the case - I had some (very few, but still) prior to GA release, yet still after its release essential docs (e. g. both methods in my OP are part of any new MAUI project) remain missing. |
Understood, and I agree that many API docs are still missing. My comment was that prior to GA there were essentially ZERO API docs visible in VS, and starting with GA (released this week) there are many thousands of API docs available. Unfortunately, the APIs you mentioned are still not available. |
repro with vs main build (32605.41.main) |
Duplicate of #3960 |
Duplicate of #3960 |
For anyone stumbling on this, the API docs are now published here: https://learn.microsoft.com/dotnet/api/?view=net-maui-6.0 While all the APIs are there, not all have a complete/accurate description yet, we're working hard on making that happen. Of course you are welcome to contribute to that. Thanks! |
Description
Plenty of MAUI's API documentation is missing within VS IntelliSense, e. g. after typing
none of the
MauiAppBuilder
extensions, e. g.UseMauiApp<T>()
or evenConfigureFonts()
, provide any information besides their method signature due to missing XML docs within their source code:maui/src/Controls/src/Xaml/Hosting/AppHostBuilderExtensions.cs
Lines 29 to 33 in 0ace122
maui/src/Core/src/Hosting/Fonts/FontsMauiAppBuilderExtensions.cs
Lines 16 to 20 in 0ace122
Steps to Reproduce
CreateMauiApp()
insideMauiProgram.cs
.MauiApp.CreateBuilder()
, type a.
after the closing parenthesis.Version with bug
Release Candidate 3 (current)
Last version that worked well
Unknown/Other
Affected platforms
iOS, Android, Windows, macOS, Other (Tizen, Linux, etc. not supported by Microsoft directly)
Affected platform versions
Any supported platform version up to now
Did you find any workaround?
Nope. 😢
Relevant log output
The text was updated successfully, but these errors were encountered: