[NO MERGE] Testing API Reference

[timunie]

What does the pull request do?

What is the current behavior?

What is the updated/expected behavior with this PR?

How was the solution implemented (if it's not obvious)?

Checklist

• Group TOC by Assembly if possible

• Filter private API by Xpath

• Add hints for Unstable, Experimental or NotClientImplementable attributes

• remove RemoteProtocol package from documentation source

• bonus: test how md output looks like

Breaking changes

Obsoletions / Deprecations

Fixed issues

[avaloniaui-bot]

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

[timunie]

Adding own Attribute badges at the moment only works if we copy and modify the presentation style. For some reason I had issues to get the correct base-path so hardcoded it for now.

https://timunie.github.io/Ava-ApiTests/html/T_Avalonia_Input_Platform_IPlatformDragSource.htm

Long-Term: If we are happy with it, I'll also ask SHFB Team if they are interested in adding this kind of flexibility. I think it could be useful for others as well.

[timunie]

Update2: filtering out PrivateAPI was quite simple using X-Path.

[timunie]

Upd 3: Grouping the TOC by Assembly may be possible but no straight forward way found as of now. I gave up on this for now.

Upd 4: Added an icon for namespace groups because it is confusing otherwise imo.

[timunie]

Okay md files are not that great imo:

I prefer to stick to html output if team agrees. A MD plugin could be written if we had much more time / capacity to do so. But it needs to be docusaurus compatible and the curent one isn't.