Why diagrams beat paragraphs
A system description is hard to hold in your head; a diagram shows every part and connection at once. It is the fastest way to onboard a developer, spot a missing piece or agree on a design before anyone builds it.
Which diagram should I choose?
Architecture shows the parts of a system and how they connect. User flow shows the steps a person takes. Sequence shows the order of messages between parts for one action, such as checkout. Database (ER) shows tables, their key fields and how they relate.
What is Mermaid?
Mermaid is a text format for diagrams. GitHub, GitLab, Notion, Obsidian and many documentation tools render it directly, so the diagram lives next to your code and stays easy to update.
Copy the code block from your result and paste it into any of them, or into mermaid.live to edit it visually.