Re:Explaining Code Using ASCII Art
by ktpsns on Monday February 18, 2019 @03:09PM
(#19193920)
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.
[ Parent
| on HN ]
I started to use ditaa (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/)
There is plantUML. Then diagrams can live alongside source code and be under version control.
Found this which looks pretty neat https://github.com/jbn/IPlantUML