Plus one for C4 Models. Most important aspect of it: When you do lines and boxes in a diagram, put descriptions on the lines, not just the boxes. Sounds simple, but is often forgotten. The result is people seeing UML, making all sorts of assumptions.
An alternative to PlantUML is MermaidJS, which GitHub recently added support for in Markdown documents.