> can often get concepts across faster than plain documentation by using imagery that would stand out in a plain readme

This reminds me of why's (poignant) guide to ruby

https://poignant.guide/book/chapter-1.html