Speaking of this, I feel really strongly that docs should be written in the present. I'd remove this whole first line.