add instructions, clean up markup