updates to go with Part 2 of the article