Sure, but you don't have to go as heavy handed as UML. You have to wonder if a visual diagram is the best way to go into detail or should we use other ways of d

Sure, but you don't have to go as heavy handed as UML. You have to wonder if a visual diagram is the best way to go into detail or should we use other ways of delivering that information? I'd say this is suitable to give to an engineering team, along side a table with some endpoint detail, or even just the swagger. https://v2.developer.constantcontact.com/dotAsset/991381b5-0917-4799-b76a-b87f45a9d9f0.png https://v2.developer.constantcontact.com/dotAsset/991381b5-0... Whereas this is too much information and too hard to decipher at a glance: https://docs.microsoft.com/en-us/azure/active-directory/develop/media/v2-oauth2-device-code/v2-oauth-device-flow.svg https://docs.microsoft.com/en-us/azure/active-directory/deve... Diagram the higher level, leave the detail to other mechanisms.