Diagrams! So much documentation lacks diagrams because they are hard to make

True! Though I’d argue diagrams as code like PlantUML or Mermaid are better than an image!

Agree just from a text search perspective alone that Mermaid even ASCII diagrams are usually preferable.