docs! omg!

review by @jsuereth