Comment by w_t_payne

Diagrams are great for communication and collaboration with non technical experts.

Code is great for creativity and working in the flow state.

Both are useful. I'd also argue that both are necessary.