@nicholas is working on a really cool feature that will allow you to set a markdown description on your flow deployment page that will beautifully render in the UI - will this solve your use case?
other than that, the logs UI page is so great - I believe logging the information about the flow run state like a summary log message with some emojis can probably help a lot