-
Notifications
You must be signed in to change notification settings - Fork 1.9k
Description
We currently have some API doc support happening for Inline XML code docs (there is a separate issue for reviewing and documenting requirements around inline docs: #3936 )
We also have an existing set of API Docs for Xamarin.Forms: https://github.com/xamarin/Xamarin.Forms-api-docs
We need to decide on the best way forward to complete the MAUI API docs. There's some questions around the best way to do this. Here's a few questions to provoke some thoughts:
-
Do we write some automation to bring the existing Forms API docs over and rework namespaces?
-
If we port existing docs, should we mostly add tags inline in code to point to the old docs?
-
There's some longer docs that would be messy to inline in source code, should these be split into conceptual docs and shortened/linked to conceptual docs in the API docs?
-
First pass at porting doc comments from Forms API docs #4099 - Imported old api docs via inline xml doc comment imports
-
API docs need to be available on the API browserAvailable on https://learn.microsoft.com/en-us/dotnet/api/?view=net-maui-6.0