updated instructions and improved markdown