1.01 dev

fixes from example validation testing and documentation