final version

instructions updated and code validations