How to generate API docs for multi-targeting projects

[AArnott]

I have a multi-targeting library. It targets netstandard2.0, net8.0, net8.0-windows and net8.0-macos. How do I generate API docs such that the docs include APIs that are unique to a particular TFM? Right now, the docs omit the net8.0-macos specific APIs at least.

In addition to the requirement of including the union of all APIs across all TFMs, I'd very much like the documentation to mention which TFMs support each API, and/or a way for users to filter the displayed APIs to a particular TFM.

[TheBoxyBear]

I've yet to try it for myself in my TFM project, but DocFX seems to at least have bare support for multi-targetting based on release notes. You can specify the project as a source multiple time, with a different target frameworrk to build against for each one, then merge the yamls. It also seems to let you tag a framework version as a "platform" for the files of the respective sources.

https://github.com/dotnet/docfx/blob/c4447a95/RELEASENOTE.md#v216