doco

Reviewed at https://rbcommons.com/s/twitter/r/783/