several readability improvements
first draft of week 5
minor readability improvements