We use quite a bit of both API triggered and Teams triggered workflows.
I often get asked if there is any documentation for what is needed by a Workflow.
It would be nice if there was some form of Swagger like documentation that would auto generate for a Workflow. I know this is challenging, not sure how others have done this if attempted.
For Teams, I do use an Adaptive Card to help generate the messages that the RegEx uses, but I have to manually update this every time something changes