I am working on some software in dotnet 8 that's responsible for broadcasting payloads to config defined webhook URLs. I would like to be able to provide a YAML schema file to describe the payloads so that the developers of the recipient systems can generate models their side. I would like to include the XML comments and relevant attributes defined in the model.
Is there a "proper" way of doing this?
If I were doing this for an API it's relatively simple, I would just include swagger as that does the heavy lifting. However as an "outgoing" project, there obviously isn't an API so I don't quite know how to hook in to things to generate what I'm after.
Any ideas?