extensive updates to explanations and storyline