The most important single aspect of software development is to be clear about what you are trying to build.
Illustrations should not just decorate the text; they should expand it.