(Should we ask @shnayder  to look at this phrasing about grading oddities -- how much do we want to talk about best practices in this part of the documentation?)