News for hackers. Stuff that matters.
Re:Slop Cop by abustamam on Saturday April 18, 2026 @12:53AM (#47813238)
For better or for worse my team has standardized on using Miro for technical designs and diagrams. It's a lot easier to visualize the system in a diagram than it is to talk about it in prose.

I think it's important to choose the right medium for communication though. Some things just need to be written out concisely.

Re:Slop Cop by ljm on Saturday April 18, 2026 @10:07AM (#47816044)
Mermaid has been great for a similar reason. For example, you can render a mermaid diagram inside a PR description on GitHub.

Comes in handy when describing a state machine or the flow of data.

Re:Slop Cop by abustamam on Saturday April 18, 2026 @09:27PM (#47821055)
Yeah! I recently discovered those, mainly because Claude seems to love mermaid diagrams, and Cursor has a renderer for it (it's not great but it's pretty easy to port to Miro)