For PRs that require more explanation/context, we include mermaid diagrams in the PR description. Github renders these natively. Today, I have to nav back to Github any time I’m reviewing or updating a PR with diagrams.
https://github.blog/2022-02-14-include-diagrams-markdown-files-mermaid/