Being able to include diagrams of what code is doing _inline_ is something that is vastly over looked by the majority of developers.
It's one of the better parts of literate programming without typesetting.
replies(1):
[1] https://blog.regehr.org/archives/1653 [2] https://news.ycombinator.com/item?id=31891226