Mermaid is also supported in GitHub, GitLab, and IntelliJ. Use it; a diagram is worth a thousand words.

https://github.blog/developer-skills/github/include-diagrams...

https://handbook.gitlab.com/handbook/tools-and-tips/mermaid/

https://plugins.jetbrains.com/plugin/20146-mermaid