- cleaned up the examples a bit
 - added comments