cleaned up readme
updated composer.lock
updated examples
started implementing validation