@WAHa_06x36 @V4N4D1S I'd say if your code needs an /inline/ diagram to explain it, your code is likely unreadable and so must be rewritten.

Documentation of the public API (which this one isn't) on the other hand could, which JavaDoc and similar ones tend to allow via rich-text/hypertext formatting.