News for hackers. Stuff that matters.
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.
Re:Explaining Code Using ASCII Art by pgeorgi on Monday February 18, 2019 @05:04PM (#19194897)
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/)

Re:Explaining Code Using ASCII Art by emp on Monday February 18, 2019 @04:37PM (#19194694)
There is plantUML. Then diagrams can live alongside source code and be under version control.
Re:Explaining Code Using ASCII Art by zokier on Monday February 18, 2019 @05:49PM (#19195199)
Found this which looks pretty neat https://github.com/jbn/IPlantUML