question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Add missing MAUI API docs

See original GitHub issue

Description

Plenty of MAUI’s API documentation is missing within VS IntelliSense, e. g. after typing

MauiApp.CreateBuilder().

none of the MauiAppBuilder extensions, e. g. UseMauiApp<T>() or even ConfigureFonts(), provide any information besides their method signature due to missing XML docs within their source code: https://github.com/dotnet/maui/blob/0ace122b75382a43ae8ff7dbbdf1cb4d55703cc8/src/Controls/src/Xaml/Hosting/AppHostBuilderExtensions.cs#L29-L33 https://github.com/dotnet/maui/blob/0ace122b75382a43ae8ff7dbbdf1cb4d55703cc8/src/Core/src/Hosting/Fonts/FontsMauiAppBuilderExtensions.cs#L16-L20

Steps to Reproduce

  1. Create a File > New .NET MAUI App
  2. Go to CreateMauiApp() inside MauiProgram.cs.
  3. At the line with 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

None available. 😢

Issue Analytics

  • State:closed
  • Created a year ago
  • Reactions:2
  • Comments:8 (5 by maintainers)

github_iconTop GitHub Comments

3reactions
Eiloncommented, May 26, 2022

@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.

3reactions
Eiloncommented, May 25, 2022

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.

Read more comments on GitHub >

github_iconTop Results From Across the Web

Troubleshoot known issues - .NET MAUI
Learn about .NET MAUI known issues and troubleshooting you can do to resolve these issues.
Read more >
NET MAUI Community Toolkit documentation
The .NET MAUI Community Toolkit is a collection of reusable elements for application development with .NET MAUI, including animations, ...
Read more >
Missing reference from Package ZXing.Net.Maui Barcode ...
Net.Maui package but a different one that seems to relate to the other package. I installed the 1.0.4 since the 1.0.5 version is...
Read more >
Referencing .Net Core project from .NET MAUI
I have 2 projects in my solution - .Net Maui(GUI) and ASP.Net Core Web API(API). After adding a project reference to my GUI...
Read more >
Call a Protected API from a .NET MAUI App
This article will show you how to call a protected API from a .NET MAUI application by guiding you in the process of...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found