Update docs with suggestions from Kenton part 2