macos and ios workloads do not seem to ship API documentation

[sandyarmstrong]

1. Create a .NET 6 macos or ios project.
2. Open the project in VSMac Preview 4 (which runs on .NET 6, and temporarily cannot load the old monodoc-based help).
3. Open some source in the editor.
4. Hover over a type like UIViewController or NSMutableDictionary.

Expected results

Editor tooltip shows descriptive help text for the type.

Actual results

Editor only shows bare type information, no descriptive help text.

---

I am working on bringing back monodoc support to VSMac, which would allow loading help text from the documentation that ships in /Library/Frameworks/Xamarin.iOS.framework/Versions/Current/share/doc/, but that isn't really correct.

Based on how it seems to work for the rest of the .NET 6 packs, I think workload API docs should be in XML files that ship alongside their DLLs. System.* types get descriptive help text in editor tooltips without issue.

[sandyarmstrong]

Expected

Actual

[rolfbjarne]

@jonathanpeppers how does XA handle API documentation in .NET? Do you handle documentation at all?

[jonathanpeppers]

If you look at: https://www.nuget.org/packages/Microsoft.Android.Ref.31/31.0.101-preview.11.117

We still have Mono.Android.xml inside, just like we had for Xamarin.Android.

[rolfbjarne]

This is partially fixed, in that we know ship the Microsoft.iOS.xml file in the ref pack in the workload.

This means that the IDE should show any documentation in the xml file - the problem is that the file is almost empty.

This last part will be handled in #14372, so I'm considering this issue half done / half duplication of #14372.