Apply documentation suggestions from code review
Apply documentation suggestions from code review

Co-authored-by: Guillaume Gomez <b1db332606efda9d9987ee09ce352e2a96143e72@gmail.com>
aidancully/rust,aidancully/rust,aidancully/rust,graydon/rust,graydon/rust,graydon/rust,graydon/rust,aidancully/rust,graydon/rust,aidancully/rust,aidancully/rust,graydon/rust