I yammer about documentation, combining images and text.
I have posted a primitive example here:
It is about the mechnism to add capability to Inkscape with Python code.
I like the connection of code to the result in the GUI.
I like the triangle between the 3 uses of "text" in the code, illustrating the requirement for synchronization.
I like the screen grabs of using the application; setting password in winpdb, attaching to demo.py, with a highlighted connection to the germane line in the script. I consider screen grabs of what is being done much more informative than a textual description.