updates player instructions and feedback, eliminates debugging puts, adds documentation