5 ms·
Since some of these examples seemed to be part of a documentation system such as Javadoc, Sphinx or Doxygen, I wonder wether the more complicated examples would
by ktpsns 8y ago
Since some of these examples seemed to be part of a documentation system such as Javadoc, Sphinx or Doxygen, I wonder wether the more complicated examples would not be better made as proper drawings. It may be nerdy to draw huge diagrams in the text editor, but they are error prone (sometimes due to bad visualization). Instead, with a proper UML diagram editor or with Inkscape, such diagrams are quickly exported to SVG/PDF standard and rendered as a nice picture within the given documentation system. Drawback: They are no more part of the source code.
- emp 8y agoThere is plantUML. Then diagrams can live alongside source code and be under version control.
- zokier 8y agoFound this which looks pretty neat https://github.com/jbn/IPlantUML https://github.com/jbn/IPlantUML
- pgeorgi 8y agoI started to use ditaa (http://ditaa.sourceforge.net/ http://ditaa.sourceforge.net/) to render inline ascii art diagrams into something "pretty". asciidoctor supports that (and lots of other specialized diagram tools) with little effort (https://asciidoctor.org/docs/asciidoctor-diagram/ https://asciidoctor.org/docs/asciidoctor-diagram/)