We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also used
[Diagrams.net](https://www.diagrams.net/)(formerly`draw.io`). Other alternatives:
...
...
@@ -793,3 +793,25 @@ We currently use [Graphviz](https://graphviz.org/) to draw charts, but have also
TODO: make a section about diagrams, how to make them, why they are
useful, etc. See [this for inspiration](https://sportebois.medium.com/better-architecture-diagrams-for-agile-teams-actionable-tips-and-lessons-e76627dc4315).
Normal graphic design tools like Inkscape, Dia, Krita and Gimp can of
course be used for this purpose. Ideally, an editable and standard
vector format (e.g. SVG) should be used for future proofing.
For this, clipart and "symbols" can be useful to have reusable
components in graphs. A few sources:
*[inkscape-open-symbols](https://github.com/PanderMusubi/inkscape-open-symbols)([Debian package](https://tracker.debian.org/inkscape-open-symbols)): ships a bunch of
icons from multiple sources (e.g. Font Awesome) directly usable in
Inkscape, lacking a few which are suggested [IMKL](https://github.com/PanderMusubi/inkscape-open-symbols/issues/91), [OSA](https://github.com/PanderMusubi/inkscape-open-symbols/issues/38),
