Fix ambiguous and dead inheritdoc links

[ScrubN]

What does the pull request do?

Explicitly defines documentation in places where it is from an ambiguous base class/interface or where it is no longer valid due to inheritance changes.

What is the current behavior?

Certain methods, such as Dispatcher.Post(Action, DispatcherPriority), fail to resolve documentation with Rider/ReSharper.
Other methods, such as ExperimentalAcrylicMaterial.Invalidated, have dead inheritdoc links.

What is the updated/expected behavior with this PR?

Rider/ReSharper successfully resolves the documentation of the affected methods.

Checklist

• Added unit tests (if possible)?
• Added XML documentation to any related classes?
• Consider submitting a PR to https://github.com/AvaloniaUI/avalonia-docs with user documentation

[ScrubN]

While working on this PR, I think I found a bug - ExperimentalAcrylicMaterial.Invalidated is a dead inheritdoc link. Based on 9eaacef I think ExperimentalAcrylicMaterial is supposed to implement IAffectsRender, though it was implemented by the interface IMutableExperimentalAcrylicMaterial in this case, but in 64610c2 IAffectsRender was removed from the interface without being added to ExperimentalAcrylicMaterial.

If I am correct, do I have permission to add it to this PR? Or would a separate PR be preferred?

[cla-avalonia]

• All contributors have signed the CLA.

[ScrubN]

@cla-avalonia agree

[avaloniaui-bot]

You can test this PR using the following package version. 12.0.999-cibuild0061193-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[maxkatz6]

@ScrubN brush invalidation was removed from other brush types, and it seems to still be used here. Better to add simple xml doc specifically on this implementation, without changing any interfaces.

[avaloniaui-bot]

You can test this PR using the following package version. 12.0.999-cibuild0061251-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[avaloniaui-bot]

You can test this PR using the following package version. 12.0.999-cibuild0061257-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]

[MrJul]

Note: some fixes here actually introduced actual compiler warnings, see #20429.

[ScrubN]

Note: some fixes here actually introduced actual compiler warnings, see #20429.

Oh, I'm sorry! I didn't have the free space to fetch the missing workloads to test compile and ReSharper solution analysis didn't catch it.

[MrJul]

No worries (we'll hopefully be enabling warnings as errors soon on CI).
Indeed ReSharper/Rider resolves those crefs correctly but the C# compiler doesn't.