Man tools like graphviz, plantuml, mermaid, kroki, and similar text-based diagramming tools have such awesome potential... if only they fixed a handful of issues they might actually be usable on larger or more complex graphs... as it stands you waste most of your time trying to layout things "suggestively".
Vanavond heb ik met behulp van #PlantUML de frontend van mijn schaakapplicatie gedocumenteerd als #ClassDiagram. Dat werkt wel lekker. Lekkerder dan iets als #DrawIO. Bij de laatste moet je elk pijltje met de hand tekenen, terwijl je bij de eerste uiterst simpele configuratiecode schrijft op basis waarvan PlantUML dan zelf aan het tekenen slaat. Je kunt alleen geen pijlen tussen methodes trekken.
#PlantUML is verkrijgbaar als plugin voor #IntelliJ. Er bestaan ook plugins die hand in hand met deze plugin werken en #UML-diagrammen genereren op basis van je #Java-code. Deze zijn alleen onleesbaar, niet of nauwelijks te configureren of komen juist met de wereld aan instellingen, die niet lijken te doen wat ze zouden moeten doen, terwijl elke vorm van documentaire ontbreekt.
https://nixos.org/manual/nix/stable/introduction.html is good, but I like visual concepts, and didn't find them. When I'm clear about a system, I generally build a visual concept map. Will try to write one in #plantuml as I go along, and will see how it turns out!