word-smithing and cleanup
added samples link to readme