illustrations and some tweaks