Update docs with suggestions from Kenton