tweaked formatting and linked to Susan's example which prompted restructuring
improved commenting